
SPD 10/25 INTELLIGENT TERMINAL SYSTEM 
PROGRAMMER’S REFERENCE MANUAL 



April, 1977 


MS-7217 



PREFACE 

The INCOTFRM SPO 10/25 Intelligent Terminal is a compact j 
versatile system which has found application in a wide variety of 
envircnments* such as banking systemsj airline reservation 
networks cr as a stand-alone intelligent terminal system# 

This is the $PD 10/25 Programmers Reference Manual* When used 
with the SPO Symbolic Assembly Language Reference Manual* it is 
the only manual needed to program a SPO 10/25 terminal aionej cr 
running under SPD/POS* 

The information in this manual is presented for informational 
purposes only and is not intended or licensed to be used for the 
construction of equipment* The information is believed to be 
accurate* but nc responsibility is assumed for inaccuracies or 
for the consequences of using the information* 

Further* INCOTFRM Corporation makes nc rep resent ation that use of 
the information in this manual will net infringe on existing or 
future patent rights of INCOTERM or of others* 
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SPD 10/25 Organization 


The SPD 10/25 TPU internal system organization is that cf a 
processor with the connections for a!I I/O devices* including the 
peripherals* the display monitor generators* the keyboards* the 
communications lines* a half duplex communications controller and 
a cyclic check controller* Alt other connections are made through 
a commonly shared I/O bus (see figure 1-1 ). The bus organization 
allows outside connections for devices that house their own 
controllers (for example* a paper tape reader)* and inside 
connections te the built in devices: the keyboards at every 
display station and the communications controller. The connection 
of any other peripheral device is made by simply: 

* Inserting into a TPU slot a self contained 
plug-in module* which is the controller for the 
device* and 

* Assigning its address to one of the output 
channels through which the TPU communicates with 
the controIlers• 

The controller module is a board that fits easily into the TPU 
housing. There ere slcts for any combination of five single 
devi C e contro!lers. The system is readily reconfigured to run 
with different applications programs by changing the plug-in 
moriu| es• ^ * m 


1.1 


Input-Output Subsystem 


The I/O subsystem (figure 1-2) provides the means for all 

transfer of data into a n d out of the TPU. The source for and 

target of all input and output operations is the ACR 

(accumulator). The ACR is a register which holds S bits of data. 

The common I/O bus is the path for data transmitted into and out 

I the TPU. The bus is common tc the ACR and the 8 addressable 

channels. The devices assigned to these channels are chosen when 
t e system is configured. Two targets or sources for data are 

internal to the TPU: the RTC (real time clock) and the refresh 
suosytem. The remainder are external. 

The data sources or targets are interfaced to the channels by 
controllers. The controller provides all the necessary logic to 
conduct the exchange of control information and I/O data, 
transmitting an interrupt signal Cover an exclusive line) and 
effecting the data transfer over the I/O bus. Information 

concerning controI Ier programming is not given in this manual. 

Consult the INCOTEEM Data Communications Manual for a description 
of general controller operation. 



TPU 
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SPD 10/25 Functional Characteristics 

Paral lei binaryj Byte oriented 
Data Format: 8 bit byte* 16 bit word 

Instruction Length: One or two words long 

Program Memory: Magnetic Core 

Memory Size: 4K Bytes 

Memory Cycle: 1*6 microseconds 

Addressing: Direct* multi-level indirect 

Arithmetic Code: Twc*s complement* Unsigned 

Refresh Display: MOS RAM 

Refresh Size: 2K bytes (4K: Dual 1 920 Cnfg) 


1*2* SPD 10/25 Family Architecture 


The TPU consists of a magnetic core memory* an Auto-Exec 
interrupt structure* arithmetic logic hardware* control 
registers* a pewer/save restart feature and a real-time clock. 
Figure 1-3.is a data flew diagram of the TPU illustrating the 
memory registers * arithmetic unit and I/O busses* 


1*2*1* Auto-Exec 


Auto Exec is the name applied to the SPD series unique hardware 
controlled interrupt structure* Auto-exec provides 8 levels of 
priority interrupts and performs all register storage and control 
functions required to service an interrupt* 

An interrupt is a randomly occuring signal from a device which 
requests some action from or provides some information to the TPU 
and the internally stored program* Devices which may cause 
interrupts 3re the RTC* keyboards* and alI peripheral device and 
communications controllers* The auto-exec structure provides* via 
hardware* most of the functions required to handle an interrupt 
when it occurs* 
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Figure 1-3 

SPD 10/25 Data Flow Diagram 






Auto-exec saves the programmer from the burdensome task of 
creating specie! routines to* determine the source of an 
interrupts save and restore the contents of the registers* 
request specific I/O operations and to sequence the specific 
program routines to be ^executed when an interrupt occurs. 
Programs may cr may net utilize auto—exec* Programming under the 
auto-exec structure is described in section 3® 


1«2®2® Core Memory 


Memory is non-volatile magnetic core: the contents are not 
destroyed when the system is pewered-up or down® Memory is 

lnt0 ** sectors of 512 bytes each giving a total size of 
4096 bytes (4K )• 

Each byte of memory is a ddressab I e and available to the program® 
Prog rams. can modify instructions in memory* making intelligent 
programming possible* 


1*2*3* Power Restart 


The first instruction to be executed when power comes on is 
fetched from the address contained in core location FFC* This is 
the part of the Memory Reserve area used by the hardware for the 
Power-Restort feature* Here* the program can store the address of 
the instruction or routine to be executed whenever the TPU is 
powered down and up again* 


1*2*4* Refresh Subsystem 


The refresh subsystem provides 3l! the necessary controls and 
interfaces to drive the particular configuration in use* 

The SPD 10/25 Dual 960 configuration drives two screens of 960 
characters each® It is supplied with 2K MOS RAM memory and two 
keyboards plus two display monitors* 

The Dual 1920 configuration drives two 1920 character screens* It 
is supplied with two displays plus two keyboards and 4K MOS RAM 
refresh memory* It is possible to drive up to four displays 
consisting of 960 characters each* 

The Single 1920 configuration drives one display of 1920 
characters each® It is supplied with one keyboard and display. 
Except for the lack of an additional keyboard controller and 
display* this configuration is identical to the Dual 960 
configuration* 
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The cursor is generated by the hardware but is under complete 
software control* The. refresh subsystem also contains the the 
cyclic check calculation circuit and a Code Conversion ROM table 
(see section 5*1*)* 

Character generation* cursor generation* character brightness* 
and character blink are all c ont rolled by refresh subsystem* 


1*2*4*1* Display Monitor 


The viewing.monitor and screen presentation is based on standard 
T»V* techniques and uses a 12 inch diagonal CRT (Cathode Ray 
Tube) monitor* Characters are displayed in an 3 X 12 dot matrix 
providing clear and highly readable font* The screen uses green 
P39 phosphor for high light output efficiency and resulting ease 
of viewing. The out*r surface of the CRT is etched to minimize 
reflection from surrounding sources. The viewing grid is nine 
inches wide by 6*5 inches high. The operating mode of the display 
is dynamically selectable by the software program* Select!ons 
include screens sizes of either 1920* 2000 or 960 characters and 
line lengths of 80 or 64 characters. 


1*2*4.2. Character Generation 


The SPD 10/25 display provides several upper case only and 
upper/lower case character sets. The character set employed may 
be selected by the user from these available. The character set 
chosen is generated by the refresh subsystem and the read only 
memory character generator. 

Each character is constructed from a matrix of dots which fits 
^**^£?* a display position that is in an 8 X 12 dot matix area 
within a 10 X 16 envelope. The unused portion of the display 
allows for spacing between characters and lines* Proarsmmina the 
refresh subsystem is explained in section 4* 


1*2.5. Real-Time Clock: RTC 


The RTC*.a part of the screen module and control and timing unit 
(SMCTLJ)* indicates the passage of actual time to the programmer. 
Its interruptreceive the second highest priority* The RTC 
interrupts.60 times a.second* One use of the RTC is to control 
the execution of multiple tasks so that each one is performed. 

Eor^ programming purposes* the RTC is treated as an external 
device. Programming information for the real time clock is given 
in section 7, 
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1•2•6* TPU Registers 


Six registers^ control the TPU program operations* They are 
briefly described in^ the following sections* Unlike core* the 
contents of the registers (with the exception of the PCR) are 
random when the TPU is powered—up* 


1*2* 6*1* Accumulators ACR 


The ACR* an 8 bit register* is the primary arithmetic and logical 
register of the TPU* This register is the source or target for 
data in I/O operations* 


1*2* 6* 2* Condition Status Register: CSR 


The CSR is a three hit register which indicates the status as a 
result of a 1 I arithmetic and compare operations* The layout of 
the CSR is: 


1 1 
NG^ j EG I co 

Negative 1 Equal i Carry Cut 


Set if Msb of ACR 
is 1 following an 
arithmetic oper* 


Set if the result 
cf an arithmetic 
cper* is 0 or 
if a compare oper 
detects equality 


Set if an overfIow 
oc cured during an 
arithmetic oper or 
if a greater than 
or equal condition 
was detected 


1*2*6*3* Cursor Register: CUR* $C or $X 


The CUR is a 12 bit register used to control the display position 
of the cursor symbol. It can also be used as a general data 
register to manipulate 12 bit quantities* 

The cursor register may be loaded from cr stored into a word 
address in cere* A comparison between the CUR and a word in core 
can be made to set the CSR. 

The CUR is unique in that it is not only a hardware register but 
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also resident in the top two bytes of the Top sector* FFE-FFF* 
Whenever the cursor register is modified by an instuction* the 
hardware automatically updates the core word located at FFE. 

In case of a power-down* the contents of the CUR are lost* 
although the contents of core locations FFE-FFF are not. In order 
to rephase the CUR with the Contents of this location* a LOC $C 
instruction must be issued* The assembIer automatically defines 
$C to be FFE. 

Information on positioning the cursor is given in section 4.* 
Refresh Subsystem Programming. 

The cursor register is divided into two fields* the line register 
field (LIR) and the character register field (CHR)s 



1 LIR I CHR I 

I L i 


Cursor Register 


In 64 ch a r a c t e r/l i r.e mode* the LIR and CHR correspond to the line 
and character position respectively where the cursor will appear 
when enabled* Instructions are provided for moving the ACR to and 
setting it from these fields* 

The LIR. and^ CHR are NOT separate registers* nor do they 
necessarily indicate where data will be displayed on a screen. 
They a r e cursor register fields that can be used as general work 
areas to suit the needs of the software program. 


1.2.6.4* Memory Address Register! MAR 


The MAR* a 12 bit register* stores the address of the memory byte 
or word* 


1.2.6.5. Memory Data Register! MDR 


The MDR* a 12 bit register* transfers all data to and from core 
memo ry . 
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1*2* 6* 6* Prcgram Counter R egister* PCR 


The P CR * a 12 bit register* contains the address of the next 
instruction to be executed* The PCR always references the 
high-order (even) byte of the two or four byte instruction* The 
PCR is set after th* execution of an instruction* or as a result 
cf auto-exec action* On powering up the Tpu* the PCR is 
automatically set to the contents of the word at the newer 
restart location* FFc* 




Memory Addressing 


The core memory is divided into S sectors corresponding tc a 
memory size of 4K* The Top and T cp-1 sectors maintain a special 

significance: some instructions ca n address these sectors from 

anywhere in core. 

Normally* one word memory reference instructions can not 
reference addresses out of the current or Top sectors* However* a 
word containing the referenced address (called a link or pointer) 
can be placed in the Top sector and that address can be 
referenced from anywhere in core. The technique of resolving 
adursss references employs indirect addressing which is 
described in section 1.3*2. 

The Top sector contains the memory reserve area. This area 3 FD 4 
through FFF, contains 20 bytes used by the auto-exec interrupt 
hardware^ 2 bytes to denote the value of the cursor reaister and 
2 bytes for the power restart address* 

The memory reference instructions use direct or indirect 
addressing to obtain an effective address in the core memory. An 
effect ive^ address* as opposed to the operand address specified as 
P3rt u* u tn f m ? mory reference instruction* is the ultimate address 
on which the instruction acts* The two types of addressing are 
described in the following sections* 


1*3*1* Direct Addressing 


In a two word instruction* the second word contains the 12 bit 
effective address* In a one word memory reference instruction* a 
12 bit address is derived from the 9 bit address field of the 
instruction and the PCR* if the reference is to an address within 
the current sector*^ If the address lies in the Top sectors* the 
remaining address bits are derived from the sector field* bit 
location 9* instead of the PCR® 

As noted earlier* one-word memory reference instructions may 
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never directly reference addresses out of the current sector * 
except when they lie in the Top sectors* 


1• 3 • 2 » Indirect Addressing 


Indirect addressing in fundamental to SPD programming. This type 
ct addressing is best explained by a n analogy. 

Suppose s messenger is to deliver a parcel to a certain office 
number* He dee net know to what office the parcel must 
ultimately be delivered* but he is told to go to room 400 where 
he will receive further instructiens• 

Upon arriving at room 400 he finds a note instructing him not to 
leave the pa reel here* but to continue to room 500. At room 500* 
the messenger finds a secretary waiting expectantly for the 
parcel. This is multi-level indirect addressing. 

The SPD hardware^ operates in a similar fashion. A memory 
reference instruction is using indirect addressing if bit 10 in a 
one yQrd^instruction or bit 15 in the address word of a two word 
instruCuicn is one. The word whose address is aiven by the 
instruction is then inspected. If bit location 15 is~0* the word 
contains the effective address* 

If bit location^ 15 is 1* then a second word given by this 
indirect address is examined* This process continues until a word 
whose^ bit 15 is 0 is inspected* The address contained in this 
word is the effective address. 

All instructions using indirect addressing must always reference 
an even (word) address^ 

pitfall which must be avoided when employing indirect 
addressing is having the program enter an infinite indirect loop. 
This situation may stem from one of two roots. An indirect word 
may be referring back to the original indirect reference* or the 
program may have 'blown up* ana is executing random core data. 
Beth situations indicate fatal programming errors. 
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Instruction Repertoire 


TJre^instruction^ repertoire can be divided into nine classes-* 
and cperate° lnCrenient3 compare -and-jump* test-jump* immediate 


2.1 


Word Format 


,! "r° r '-r 0r n d h u S Ubits and is divided into an even and an odd 
yt * Slt f c through 7 are the low order byte and bits 8 through 
1 5re th f" order (even) byte* Some instructions can 

reference the oda or the even byte cf the memory word* while some 

given n beloHl erenCe ^ byte * The format of a memc " “°rd is 


+-« - + - + -+- + -— + - _ + . 

1 I I I | | | 

I .15 I 14 I 17 I 12 I 11 | 10 I 

1 1 l ! 1 I | 


I i 

9 1 S| 
l I 




Even Byte Address = x 


1 1 * * I 1 l l 8 

1 7 16 1 5 14 1 3 1 2 1 II 0 1 

j 1 * I I I I | | 

Odd Byte Address = X + 1 

Memory words are addressed at their hign order (even) byte. 

1Gn ? whlch act on words (as opposed to bytes) should 

some app I icat ions^icta te ^addr es si ns ^an 3 ^odc^byte.^Ho wever* U to 

:h e 5i?s-. d 3-r:. r , sp o„ D ,; o . F "^ sr.: t1b1,ty - word c,ass 


Memory words are arranged in core in a linear fashion* 
byte always being the higher address* 


their odd 


.+ ——-- - 

I 

I Memory Word 1 

I 

+ -- 

15 even 7 odd 


Memory Word 2 


■ + 
? 
I 
I 

■ + 
0 


15 even 


odd 
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2 . 2 . 


Instruction Formats 


This section describes the format of the one-word non-memory 
reference*^ one-word memory reference and two-word memory 
reference instruction set used in all SPD 1G/25 terminals* 


2.2.1. Notation Used 


All machine instruction codes are given in hexadecimal notation. 
Hex notation is standard SPD series convention, since the machine 
structure is based on powers of 16 (i.e., 16 bits = 1 word). 

Special lower case symbols are incorporated into the machine cede 
°I • ^° Se instructions which contain implicit instruction fields 
(fields ^ which are defined at cede generation time)* An 
explanation of the symbols used follows. 

Memory reference instructions can address two types of data. 
Instructions which can reference odd cr even bytes represented by 
the occurence cf ea in their instruction cede. Instructions which 
can act only cn an even address (i.e., word address) are 
represented by the occurence of wa in their code. 

The address word of two-word instructions is represented by a 
-dash. Function and device channels for the TIO, CIO, RIO and WIO 
instructions are represented by f and c respectively* 

Instructions which contain their own effective data (e.g., 
immediate class) are represented by the occurence of ed in their 
instruction cede* 


One-word Non-memcry Reference 


The cne-word, ncr-memory reference instructions have three 
formats* The immediate, I/O and operate class of instructions use 
tnese format s* 


2.2*2*1. Immediate Class Format 


The Immediate^ class of instructions contain their cwn data 
constants in bits 0 through 7 of the the second byte. This byte 
is called the effective data field. Bits 8 through 10 are not 
used* Bits ii through 15 denote the operation code (opcode) which 
is used by the TPU to select the operation to be performed* The 

format of the in-mediate class of instructions is illustrated 
belows 
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I Opcode I Un Used I Effective Data Field | 

1 » » I 

+ ----- + - --------; _ + 

15 11 1C 8 7 0 

The instructions of the immediate class are described on the 
foI I owing pages# 

Mnemonic Definition Code Description 


LDI 


Load 8Ged 

Immediat e 


Places the effective data 
in the AC R * The original 
contents are lost* The CSR 
does not change* 


ADI Add 90ed 

Immediate 


Adds the effective data to 
the contents of the aCR* 
leaves sum in ACR* The 
original contents are lost* 
The bits in the CSR are set 
according to table 2-2* 
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Mnemonic Definition Cede Description 


S8I Subtract 98ed 

I mm edicte 


AN I And A8 ed 

Immediate 


OR I ' Or BO ed 

Immediate 


XOR Exclusive OOed 

0 r 

I mmediat e 


CLA C lear ACR 8G00 


Adds the Two*s complement 
of the effective data to the 
ACR* The results are placed 
in the ACR and the original 
contents are lost* The CSR is 
set if the ACR was greater 
than or equal to the value of 
the effective data* The other 
bits are set according to 
table 2-2* 

Logically Ands effective 
data with the contents of 
ACR* leaves result in ACR* 
destroys the original 

contents. The CSR does not 
change. 


Logically Ors effective 
data with contents of the 
ACR j leaves result in ACR* 
destroys original contents* 
The CSR does net change. 

Logica l Iy exc1usive Ors the 
effective data with the 
contents of the ACR* Leaves 
result in ACR* destroys 
original contents. The CSR 
dues not change* 

An assembler short-cut for a 
LOI 0 instruction* Sets ACR 
to 0* CLA is not a hardware 
inst ruction* 


2 * 2 * 2 * 2 * 


Operate class of instructions 


The format cf the operate class of instructions has an 
eperation-code-extension (op ext) field. Bits 0 through 1C the 
opext field* define the various instructions. Bits 11 thrcuoh 15 
denote the opcode field* defining the class of the instruction. 
Thus* the opcode field is a constant: the binary codes do not 
chance fer the various instructions* These instructions either 
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influence the general status of the ACR or control various TPU 
operations* 


The format of these instructions is given below: 


+--——--- 

I I 

! , 1 Operation-ccde-extension 

1 Code field I Field 

I I 

+---;-- 

15 IT 10 

2*2*2*2*1* Operate Class Registers: 


I 

I 

I 

i 

* 

0 


These instructions influence the general status of the ACR* 
PCR is incremented by two following execution* The opcode for 
the instructions is 11000* 


The 
a I I 


Mnemonic 

Definition 

Code 

Description 


CLC 

Cl ear CHR 

COQD 

Sets CHR to zero. 


CLL 

C1 ear LIR 

CGOC 

Sets LIR to zero* 


MAC 

Move ACR 
to CHR 

COOS 

Moves the 6 Lsb of the 
ACR to the CHR 


MAL 

Move ACR 
to LIR 

C003 

Moves the 6 Lsb of the 
ACR to the LIR 


MCA 

Move CHR 
to ACR 

CC04 

Moves the contents of 
the CHR to the ACR 
sets the ACR two Msb 

con 

and 

off 

MLA 

Move LIR 
to ACR 

CO 02 

Moves the contents of 
the LIR tc the ACR and 
the ACR two Msb off* 

set 

SHL 4 - 

Shift ACR 

Left 4 

COO 9 

Transfers the four Lsb 
of the ACR tc the four 
of the ACR* The four 

Msb 

Lsb 


of the ACR are replaced 
with zero* The CSR is not 
affected* 


2-5 








2 •2*2*2* 2* 


Operate Class: Control 


The se instructions affect the general execution time or affect 
the auto-exec interrupt structure of a program. The PCR is 
incremented by two. The ACR and CSR are rot changed. The opcode 
for these instructions is 11000. They are listed on the following 
pages. 


Mnemonic 

Oefinition 

Code 

MOP 

No 

cooo 


Ope raticn 


HALT 

Halt 

C001 


IOR I/O reset CGO 8 


Description 


Delays processing for 
one memory cycle 

Used only with a 
programmers console or 
built in maintenance panel 
when it is enabled. All 
activities of the TPU are 
inhibited. If a programmers 
console is not usedj or if 
the panel is not enabled* 
the instruction is treated 
as a NOP. On depression of 
Run* when the console is 
enabled* processing resumes 
with the next instruction 
or an auto-exec cycle 
occurs*- whichever is 

app ropriate. 

Resets any pending 

interrupts* prevents any 
new interrupts from 

entering the TPU and causes 
the controllers for the 
peripheral devices to enter 
their reset states. This 
instruction causes an 
automatic DSB instruction 
to be issued* Screen 
display is shut off as the 
result of an IOR. 
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Mnemonic Definition Code 


ENB Enable COG 6 

I nt er rupt 


DSS Disable COO 7 

I nt er ruot 


WAIT Wait COG F 


Descript ion 


Places the TPU in a mode 
which allows interrupts to 
occur* The effect of this 
instruction is inhibited 

until the next instuction 
is executed* When a 
peripheral NAKs* (fails to 
acknowledge a Rio* WIO) the 

auto-exec issues an 

automatic EN3• 

Places the TPU in a mode 
which prevents interrupts 
frcm occurring* AN current 
interrupts remain active 
however* It is issued as a 
result of an IGR 

instruction or as the 

result of an interruot from 
a peripheral device* 

Fnables interrupts and 
causes the TPU to wait* No 
instructions are executed 

until an interrupt occurs* 
An interrupt causes normal 
auto-exec action* When the 
interrupt processing is 
completed* the instruction 
following the WAIT is 
executed* 


2*2*2*3* I/O class format 


The format for the I/O class of instructions have five fields. 
Sits 0 through 3. the device address field, denote the peripheral 
device being addressed. Bits 4 through 7 the function field, 
denote to the controller what action is to be performed. 3its 3 

p?n 9 ti^ e o ( ? eX 5 n f i eld ' define the various I/O instructions (CIO. 

10 1S _, used snd CSn be set t0 zero « sits 11 
through 15* the opcode field* denote the class of instruction* 

The format for the I/O instructions is given below: 
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i ■. . ■ ■ : I .. . - l . • ■ ■ I ■ I '■ ■ ■ ■ ■■■ . | 

I Opcode I Not I Opext I Function 1 I/O Device 1 

I Field I Used I Field I Field ! Address ! 

1 I I I I | 

-- + --- + --- - 

15 11 10 9 8 7 4 3 n 


These instructions provide access to the various controllers* 
RTCj and Refresh Subsystem* These functions include reading and 
writing data j masking and unmasking interrupts and other device 
specific controls* The I/O address selects the peripheral device 
to which the information is going* the refresh subsystem or the 
the^RTC# The function field instructs the selected device of what 
action is to be taken* The CSR is not affected* The opcode is 
11001* The instructions in this class are given below: 


Mnemonic Definition Code Description 


CIO Control C9fc 

I/O 


When this instruction 
is issued* the selected 
peripheral device c 

performs the specified 
function f* The contents 
of the ACR are a va liable 
if auxiiia ry dat a is 
required to execute the 
command* This instruction 
never causes action by the 
auto-exec* The ACR is not 
affected and the PCR is 
incremented by two* An 
interrupt cannot occur 
between a CIO instruction 
and the immediately 

following instruction* 








Mnemonic Definition Code Description 


RIO Read CAfc 

I/O 


WIO Write CBfc 

I/O 


This instruction 
requests data from the 
selected peripheral device 
c* The type of data 
requested is determined by 
the function field f® If 
the peripheral device is 
prepared to transfer the 
required data* it 

acknowledges the request 
with an ACK signal® The 
TPU loads the data from 
the peripheral device into 
the ACRj and the original 
contents are lost* If the 
selected device has no 
data* it does not send an 
ACK signal; it NAKs the 
request® The auto-exec 
system is then set into 
motion* 

This instruction sends 
the data in the ACR to the 
selected peripheral device 
c® The type of data is 
defined by the function 
field f® If the device is 
ready to accept the cataj 
it sends an ACK signal® 
Then* the TPU transfers 
data to the peripheral 
device® If the device is 
net ready to accept the 
data * it does not send an 
ACK signal; it NAKs the 
requests and the auto-exec 
system is activated* 


2®2®3* One—word Memory Reference 


the sector f^eldj denotes the particular sector in which 
the referenced location resides* If bit 9 is one the instruction 
can reference a location in the Top sector® If the instruction is 
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already in the Top sector* it can reference the Top-1 sector when 
bit 9 is zero* 

Bit^ 10* the indirect bit* is one if the instruction is using 
indirect addressing and zero if not* 

To calculate an effective address* the following procedure is 
implemented by the hardware: the sum of the address of the 
referenced sector and the value of the address field of the 
instruction is calculated* If bit 10 is zero* the instruction is 
using direct addressing* and the calculated sum is the effective 
address* 


Table 2-1 Sector Addressing 


9-i t 9 Sector being referenced: 

S Current N£ Top Current E0 Top 


0 Current 

1 Top 


If bit 10. is a 1j the instruction is using indirect addressing* 
The word whose address is the sum of the above calculation must 
then be in soected• ^If bit 15 cf that memory word is zero* the 
effective address es equal to the value of bits 0 through 14 of 
that word. If bit 15 of the memory word is one* an additional 
word whose address is equal to the value of bits 0 through 14 is 
inspected* This process cont inues untiI a word with bit 15 equal 
to zero is obtained* This iterative process is multi-level 
indirect addressing. The effective address is equal to bits 0 
through 14 when bit 15 is zero* 


+ -—--— — 



i 



I Opcode 

Field I 

Indirect 

i 

Sector 1 




e it 

i 

Bit 1 

Address Field 



i 

i 

S I 


+- 



i 



15 

11 

10 


9 S 



Top-1 

Top 
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2»2*3.1» Instruction Codes 


One-word memory reference instructions can always be represented 
unambiguously in binary notation. However* since binary 
instruction^ representation is notoriously cumbersome* 
representation of machine codes is usually given in hexadecimal 
or octal. The SPD series instruction set is given in hex 
notation. 

Instructions of the one-word memory reference class use fields 
which do not break up into groups of 4 bits* making alternate 
representations of the instructions possible. For example* a 
current sector Load instruction from address ICC has the 


representations 

00000 0 0 10C0000QC 0100 

2 16 

A Load from address 0* however* is represented as* 

0 0000 G 0 00000GC0Q 0000 

2 16 


Thus* the first two hex digits* which contain the opcode* 
indirect and sector bits* vary depending cn whether the hsb of 
t e 9 bit address is on* whether the instruction is using 
indirect addressing or whether the referenced byte lies in the 
current sect or. 

The hex re p resentaticn cf instruction codes used in this manual 
always gives the lowest representation of the instruction (all 
sector and indirect bits* plus bit 8* off). However* the 
alternate re p resentat ions should be kept in mind when working cut 
hex instructions codes of the one-word memory reference 
instructions. 


2.2*3*2» Byte Class 


each instruction utilizes the ACR and the contents cf the byte at 
that effective address. Instructions of this class may reference 
an odd cr an even byte. 
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Mnemonic Definition Code Description 


LD Lead OOea 


ST Store OSea 


A D Add 10ea 


Replaces the value in The 
ACR with the contents of 
the byte at the effective 
address* The CSR and the 
contents of the effective 
address do not change 

Replaces the contents at 
the effective address 
with the value in the 
ACR• The originai 
contents of the byte are 
lost* If the effective 
address is in the memory 
reserve area FD 7-FFFj the 
contents of the bytes 
used by auto-exec.* power 
restarts and the cursor 
register may be modified. 
The ACR and CSr are not 
affected. 

Adds the contents of the 
byte at the effective 
address to the contents 
of the ACR* The result is 
placed in the ACRj 
replacing the original 
the contents cf the 
contents* The bits in the 
CSR are set according to 
table 2-2* 
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Mnemonic Definition Code Description 


SB Subtract 13ea 


CM 


Compare 20 ea 


AN 


Anc 


2 Sea 


Adds the Two's comp! ement 
of the byte at the 
effective address to the 
contents cf the ACR* The 
result is placed in the 
ACRj and the original 
contents are lest* The CO 
bit in the CSR is set if 
the ACR was greater than 
or equal to the contents 
cf the byte at the 
effective address* The 
remaining bits are set 
according to table 2-2* 

Adds the Two's complement’ 
of the contents of the 
byte at the effective 
address to the contents 
of the ACRj and tests the 
resuit of this 

calculation* The CSR is 
set according to table 
2-2* The contents of the 
ACR remains unchanged* 

Logically A.od's the 
contents of the byte at 
the effective address 
with the contents of the 
ACRj the result is placed 
ic the ACR and the 

Original contents are 

lost* The contents cf the 
byte at the effective 

address and the CSR are 
net affected. 
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Mnemonic Definition Code Description 


Or 30ea Logically Gr*s the 

contents of the byte at 
the effective address 
with the contents of the 
ACR• The original 
contents are lost but the 
contents of the byte and 
the CSR are not affected* 


2*2*3*3* Increment class 


These instructions perform an arithmetic operation on the word at 
the effective address* They are one-word memory reference 
instructions* If the effective address is in the reserve areaj 
the specified operation is performed on the contents of the bytes 
used for- the auto-exec* pcwer restart* and the cursor register* 
The ACR is not affected by these instructions* the PCR is 
incremented oy two after execution* The instructions of the 
increment class are listed below: 


Mnemonic Definition Opcode Description 


INC I nc rement 



50wa Increases by one the 

value of the word at the 
effective address* The 
original contents of that 
word are lost* The CSR is 
set under the conditions 
given in table 2-2 except 
that the NG bit is not 
used* INC acts only on 
the 12 Lsb of the word* 
the upper 4 bits are 
ignored* 
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Mnemonic ; Definition Code 



BFC Decrement 58wa 


IN2 Increment 6Qwa 

By t vg 


2*2•3•4• Jump class 


Desc ription 



Decreases by one the 
value of the word at the 
effective address* The 
original contents of the 
word are lost* The CSR is 
set under the following 
conditions! the CO bit is 
set for each execution 
except when the value of 
the word becomes zero* 
The EQ bit is set if the 
result is zero* The NG 
bit is net affected* DEC 
acts only on the 12 Lsb 
of the word* The upper 4 
bits are ignored• 

Increases by two the 
the value of the word at 
the effective address.; 
the original contents are 
lost* The CSR is set as 
shewn in table 2-2* The 
NG bit is net used* IN2 
acts only cn the 12 Lsb 
cf the word* The upper 4 
bits are ignored* 


These instructions cause an unconditional jump and directly 
modify the PCR* The ACR and CSR are not affected* The 
instructions cf the jump class are described below! 
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Mnemonic Definition Opcode Description 


BSwa Sets the PCR to the 

value of the effective 
address* The next 
instruction executed is 
st this effective 
address* 

78wa Adds two to the value 

of the PCR and stores 
the result in the word at 
the effective address* 
The PCR is then set to 
the va|ue of the 
effective address plus 
two* and execution begins 
there* The original 
contents of the word at 
the effective address are 
lost* 


Facn instruction operates on the Cursor register and the contents 
of the word at the effective address* The cursor register may be 
used to it. an ip u I at e the cursor symbol cr as a general 12 bit data 
register* For each instruction* the ACR dc es not not ch ang e an d 
the PCR is incremented by two* The instructions for the Cursor 
class are described on the following pages* 


NOTE: To rephase CUR with FFE, the CUR memory reserve location, 

execute the following: 

LDC $C 
or 

LDC X ' FFE 1 

It is important to realize that only 
INC $C or IN2 $0, DEC $C 

affect the contents of BOTH $C and the CUR. 


JMP 


Uncondl• 
Jump 


JSR 


Jump and 
S tore 
R eturn 


2*2*3*5» Cursor class 
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Mnemonic 

Definition 

Opcode 

LOC 

Lead 

Cursor 

R egist er 

40wa 

STC 

S tore 

Cursor 

R egister 

43wa 

CMC 

Comoare 

Cursor 

R egister 

70wa 


Description 


Replaces the contents 
of the CUR and the word 
beginning at FFE (CUR 
reserve location) with 
the contents cf the 12 
Lsb of the word at the 
effective address* The 
original contents of the 
CUR and CUR reserve area 
are lost* 


Stores the contents 
of the CUR in the word 
12 Lsb of the word at the 
effective address* The 
original contents of the 
12 Lsb of the word are 
lost * 

Adds the Two 1 s 
complement of the 12 
Lsb cf the word at the 
effective address to the 
contents of the CUR* The 
result sets the CSR 
according to table 2-2* 
The contents of the CUR 
is not changed* 


2*2*4* Tyc-word Memory Reference 


The two-word memory reference instructions have three formats* 
The test-jump and compare-and-jump classes of instructions use 
these formats* The first word of a two word memory reference 
instruction contains the opcode field and the conditions or data 
to be tested^ The second word contains the address to which the 
program jumps^if the tested conditions are met* The second word 
is identical in all^ three classes of inst ructi ons s bit 15 is the 
indirect bit and bits 0 through 14 contain the address field* 

To obtain an effective address* the following is used! if bit 15 
of the address word is 0* the effective address is equal to the 
value of bits 0 through 14* If bit 15 is a one* an additional 
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word whose address is equal to the value of bits 0 through 14 is 
inspected* This procedure centinues untiI a word whose bit 15 is 
0 is found* thus allowing multi-level indirect addressing* 


Indirect 
Field 


Address field 


+ --—— 

15 : u 


Word 2 of two-word menjery reference 


The three classes cf two-word memory reference instructions are 
described on the following pages* 


2 • 2*4»1» Ccmp are-and-jump class 


The f o r me t 
i1 lust rated 

for the 
below: 

compare and 

jump class has five fields 

15 

+ - •-— 

11 

10 

3 7 

! 

1 Opcode 

1 

+ 

1 

Field | 

1 

Opext Field 

1 

1 Effective Data Field 

1 

1 1 

1 I l 

1 1 

+-+ - 


Address 

Field 


15 


14 


Bits 0 through 7 cf the first word contain the effective data; 

8 through 1C the opext fieldj define the conditions being 
tested for; and bits 11 through 15* the opcode field* denote the 
class of instructions* Bits 0 through 14 of the second word 
denote the address in core to which the program will branch if 
the condition being tested for is met. Bit 15 (I) denotes direct 
addressing if off or indirect addressing if on* 

The instructions in the compare-and-jump class make an unsigned 
comparison with the effective data and set appropriate bits in 
the CSR* The status of the CSR is then examined* The opext field 
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the 
PC R 
of 
the 


ana t(je CSR are L c omp ar ed for various conditions. If 
conditions defined by the op ext field are met by the CSR, the 
is set to theeffeetive address contained in the second word 

t - 0n • If the VSrious conditions are not met by 
CSRi the PCR is incremented by four. The ACP. is not affected. 

Table 2-2 lists the various conditions possible in CSR when the 

twc r w 0 °or r dfo e f N n J an r. C ° bit 5 are set * The instructions occupy 
lare-Ln-- H* °Pf? de is 10100* The instructions of the 
compare and jump class care listed on the following pages* 


Table 2-2 CSR Condition Settings 


N G bit 
Set *' when 
ACR Msb 
is one 


FQ bit 
Set? when 
Arith* Op* 
Produces 0 


CO bit 
Sets when 
Arith* Op* 
Froduees CO 


Conditions 
Satisfied 


LTj LE or N E 
GT j GE c r ME 


EG CO + G)j LE 

EG (when an 
overflow occurs 
or a subtract* 
causes 0)jGE 

Positive (P0) 
when tisb of 
result is G 

Negative (NG) 
when Msb of 
result is one 


2*2*4*1»1* Performing a Compare 


In many programs it becomes necessary to make a 
between operands a r d determine if one is equal toj or 
less than the other* 


compa rison 
greater or 
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If the comparison is made using the ACR and effective data <i.e*j 
data contained within the instruct ion )» the instructions of the 
compare-and-jump class a re used* • ' 

The_ CJ class performs the indicated comparison on an ACR vs data 
basis* That is* one can remember hew these instructions perform 
their comparison by simply replacing the vs with the desired 
comparison operand: 

* ACR GT Data * 

* ACR GF Data j 

* ACR LT Data * 

* ACR LF Data * 

* ACR EQ Data * 

* ACR NE Data • 

All. that remains is to find the instruction which uses the 
desired comparison* 


2*2*4* 2* 


Compc re-end-j unrip class Instructions 


Mnemonic Definition Code Description 


CJFAL Compare-and AOed- 

Jump on 
Condition 
False 

CJTRU Compare-and A4ed- 

Jump on 
Condition 
» True 


Usea to the set the CSR 
Never jumps* 


Sets the CSR and always 
jumps* 
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Mnemonic Definition Codo Description 


CJLT Compare-and Aled- 

Jump on 
Condition LT 


Jumps if the ACR is 
less than the effective 
da ta • 


CJEQ Compare-anc A2ed- 

Jump on 
Condition EQ 


Jumps if the ACR is 
equal to the effective 
data * 


CJLE Compare-and A3ed- 

Jump on 
Condition LE 


Jumps if the ACR is 
less than or equal to 
the effective data* 


CJGE Compare-and A5ed- 

Jump on 
Condition GE 


Jumps if the ACR is 
greater than or equal 
to the effective data* 


CJNE Ccrnpare-and A6ed- 

Jump on 
Condition NE 


Jumps if the ACR is 
not equa 1 to the 
effective data. 


CJGT Ccmpare-and A7ed- 

Jump on 
Condition GT 


Jumps if the ACR is 
greater than the 
effective data. 


2*2«5* Test-jump: I/O Class 


The format for the test-jump., I/O class, has seven 
i I lust rated below: 


fields as 


1 4 11 


l 

I Opcode Field 
I 

+ - + — 

i i 

I I I 
! 1 


10 9 3 

■+ - --+— -- + 

I I I 

I JS I Opex t Field! 

I I 1 

■+ +-+ 


Address Field 


7 4 


I 

Function l 
Field I 



3 0 

-— + 

i 

Devi ce i 
Field l 

-+ 

i 

I 

I 

-— + 

0 


Bits 0 through 3 of the first word* the device 
which particular peripheral device controller is 


fields denote 
being tested* 
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A through 7i the function fields denote what test is being 
performed* Bits S and 9* the opext field* are always 00 and 
define this instruction to be a test-jump* I/O instruction* Bit 
10* the jump sense (JS) field denotes if the condition being 
tested for is true or false (0 = truej 1 = false}* Bits 11 
through .15* the encode field* denote the general I/O class of 
instructions# Bits 1 through 14 of the second word denote the 

address in core to which the program will branch if the condition 

being tested is met* Bit 15 denotes direct addressing if off and 
indirect addressing if on* 

The instructions in the test-jump* I/O* class perform test on the 
status of the various cont ro llers* In general* a controller may 
or may net respond with an acknowledge signal as the result of a 

specific test* The ACR * CSR* and cursor register are not changed 

by these instructions# If a jump is to be taken as a result of 
these.instructions* the PCR is set to the effective address 
contained in the 2nd word of the instruction* Otherwise* the PCR 
is incremented by four# These instructions require two words of 
memory. The test jump I/O ' class of instructions consists of a 
JFACK and JTACK instruction* However* for simplicity* the 
instructions will be collectively referred to as TIO 
instructions* The opcode is 11001 and the epext is GO# The jump 
sense (JS} bit determines whether a jump should be taken as the 
result of a cont roller acknowledge* 

These instructions can be used tc test the ready state of an I/O 
device* thus allowing the program to cause or prevent a NAK 
response* If the jump is not taken* an interrupt cannot occur 
before the next instruction is executed# 


M n e m on i c 

Definition 

Code 

Description 

JTACK 

Jump if I/O 
ACK signai 

Is t rue 

C 8 f c - 

Instruction causes a 
jump if the cont roller 
being tested responds 

with an ACK signal# 

JFACK 

Jumo if I/O 
ACK signal 

Is false 

CCfc- 

Instruction causes a 
jump if the controller 
being tested dees not 

respond with an ACK 

signal# 
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2 . 2•5 * 1 


Test-jump: Register Class 


f& f fietds f es inJlra^rCelo*:' 511 ^ of instructions has 


15 
+ - 

I 
I 
I 


I 

I 

+ - 
15 


11 


10 


Opcode field 

1 ! 

1 JS I 

1 1 

Cpext field 


1 

I 1 

1 

Address 

field 



14 


Bits 0 through 9 cf the first word* the opext fields define the 
eondnions being tested. Bit 10* the JS field* denotes if the 

l nd r ^ on b *™. g tested is true or false. Bits 11 trough 15 denote 
L c ^ of ’"Structions used for testing the CSR* ACR or both. 

ll tu 3 ’ I*:™ 9 * 14 ° f the seCond yord denote the address in core 

ret Wil1 ^ anch if the condition being tested is 

met. Bit 15 (I) denotes direct addressing if off or indirect 

addressing . if on.^ The instructions of the test-jump* register 
class* of instructions are descriDed on the following pages. 

the T%l~iT B Wr 9i Tf ter , ; cl 3 f s *. 0f -instructions performs tests on 
the CSR Of- ACR. I. 3 test is met* the. next instruction to be 
executed is located at the effective address. Otherwise* the PCR 

execu?ed em T^ e Arr y I° Ur 8nd ^ n6Xt se ^^ial instruction is 
executed. The ACR* cursor register* and CSR are not affected. 

T e f e l2 StruC J 1 ° n I re< 5 uire two words of memory. The tests 
opcode m is 1010 c! S ° n tHe ° peXt 3nd junip ' sense <JS) fields. The 


M nemonic 

Definition 

Code 

Descript ion 


JCFAL 

N ever 

Jump 

8800- 

Never causes a 
PCR incremented 

jump • 
by four 

JCTRU 

AIways 

Jump 

8CC0- 

Unconditional 

PCR incremented 

j ump • 
by four 

JCLT 

Jump on 
Condition LT 

8900- 

Jumps if the CO 
ze ro • 

bit is 
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Mnemonic 

Definition 

Code 

Description 

JCLF 

- Jump cn 
Condition 

LE 

8 B00- 

Jumps if the EG bit 
is one or the CO 
bit is zero* 

JCEQ 

Jump cn 
Condition 

EG 

8 A 00 - 

Jumps if the EQ 

bit is one* 

JCGE 

Jump on 
Condition 

GE 

8 DOO- 

Jumps if the CO 

bit is one 

JCGT 

Jump on 

C ondition 

GT 

SFGO - 

Jumps if the EQ bit 
is zero and the CO 
bit is one* 

JCNE 

Jump cr. 
Condition 

NE 

8EQ0- 

Jumps if the EQ 

bit is zero 

JCN 0 

Jump on 

C ondition 

N G 

8801 - 

Jumps if the NO 

bit is one 

JCPO 

Jump on 
CGndit ion 

PC 

8C01- 

Jumps if the NG 

bit is zero 

JCOD 

Jump on 
Condit ion 

Odd 

8802- 

Jumps if the Lsb of 
of the ACR is one* 

JCEV 

Jump on 
Condition 

8C02- 

Fven 

Jumps if the Lsb of 
The ACR is zero 
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Mnemonic 

Oefiniticn 

Cede 

Description 

JCCO 

- Jump on 
Condition CO 

SOGQ- 

Variant of JCGF* Jumps 
if the CO bit is 1* 

JCNC 

Jump on 
Condition NC 

8900- 

Variant of JCLT* Jumps 
is the CO bit is 0. 

SKP 

Skip next 
Word 

8800- 

Never jumps* A variant 
of JCFAL* The skipped 

word is actual1y in the 
second word of the 

test-jump instruction* 

wjmp 

Full word 

Jump 

8 COO- 

Unconditional1y jumps* 

A variant of JCTSU* The 


effective address is 
actually in the second 
word of the instruction# 


To make a decision based on a comparison, keep the following 
in mind: " 

LD DATA1 

CM DATA 2 

The comparison test, as executed by the test—jump instructions, 
is performed on a DATA1 (GT, LT, EQ, etc.) DATA2 basis. 
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3e Programming with Auto-Exec 


Auto-exec utilizes certain specific core locations in the Top 
sector memory reserve area* The auto-exec reserve area* F34-FF8 j 
is used to store and set the value of the PCR* ACR and CSr during 
interrupt processing* 

Fach^ device which may cause an interrupt has two words reserved 
for it for register storage* This block is called the stateword. 


1 


1 Net 1 

-+ — 

l 


~+ - 

i 

1 

1 

ACR 

l Used 1 NG 

1 

EG 

1 

CO 1 

1 


1 1 

1 


1 

I 

15 


8 7 3 2 

— + — 

C 

S R 

—f _ 

0 



WORD X 









” "" UL “ 



1 






1 

1 

1 


PCR 



- 

l 

1 


WORD X + 1 

Machine instructions are available which control the actions of 
the auto-exec* These instrut ions allow the program to prevent or 
allow interrupts from ail or specific devices* to wait for 
interrupts and to reset interrupts* 

Each interrupting device is assigned a priority which schedules 
the devices* .interrupt* The assigned priority* together with the 
entire memory reserve area is illustrated in the following table* 
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Tab i e 4-1 

Memory Reserve Area 


A d d r e s s 

. Area". 

P rior it y 

FFE-FFF 

Cursor Register 


FFC-FFO 

Power Restart 


FF8-FFB 

Background 


FF4-FF 7 

Rea} Time Clock 

1 

FF0-FF3 

Screen Buffer* ROM 

* 

F^C-FEF 

Device 1 Loader 

2 

FF 8-FE E 

Device 2 Keyboard 

3 

FP4-FE7 

Device 3 

4 

FEC-FE3 

Device 4 

5 

FDC-FDF 

Device 5 

6 

FD8-FDB 

Device 6 

7 

FD4-FD7 

Device 7 

6 

* used as 

the default controller 

slot 


3«1« The Bsckgrcund-Fcreground Concept 


Processing may be considered to fall into two categories: 
Background Processings 

The processing of tasks which are of a lower priorit' 
when higher priority I/O tasks are not using the systei 
resources* and* 


Foreground Processings 

The processing of the I/O requests that 
designated to preempt the use of the 
facilities (real-time programs* for example). 


have been 
computing 


The auto-exec interrupt structure provides a clean* automatic* 
program reducing tool which handies the transition from 
background tc foreground tasks. Actually* autc-exec provides the 
tacinties for multi-task programming: Foreground tasks 
processed* on a priority basis* when their interrupt occurs. 


are 
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The auto-exec prosraui/response is as follows: 

* The program is in foregrounds processing an I/O 
task* Interrupts are not allowed to occur 
(disabled)* 

* A NAK signal occurs in response to an I/O 
reauest that cannot be completed (device in a 
not-ready state)* 

* Auto-exec saves the contents of the PCR* ACR and 
CSR at the reserve address of that device* the 
Sateword* 

* Auto-exec sets the PCR* ACR and CSR from from 
the two word block at FF8* the background 
auto-exec area* 

* Interrupts are allowed to occur (enabled)* 

* Execution of the background task begins at the 
address specified by the PCR. 

Execution^ of the 1 background task continues until an interrupt 
occurs signalling that the I/O device which previously issued a 
NAK* is now ready to transmit cr receive data* Should two 
foreground tasks issue interrupts simultaneously* the higher 
priority task is serviced first. In response to an interrupt 
signal* auto-exec: 

* V-ra instruction completion iogic* waits for the 
current background instruction to be completed* 

* Determines the interrupting device f s reserve 
address* 

x Disables ail interrupts* 

* Stores the contents of the ACR* CSR and PC R into 
the background auto-exec area* FF8* 

* Sets the ACR* CSR and PCR from the device’s 
stateword* 

* Begins execution at the foreground I/O 
inst ruction• 

Execution of the foreground task continues until the hardware 
detects another NAK signal * whereupon the auto-exec cycle is 
repeated* 
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3.2. 


Programming and Auto-Exec 


The auto-exec is an extremely powerful programming tccl which can 
be found on 1 y on INCOTERM computers. It should be noted that 
there can be up tc 8 interrupting devices and respective I/O 
handlers. Two programming precautions* however* are necessary 
when using autc-exec: 


1. Interrupt Nesting! allowing an interrupt to 
occur while already in foreground is a fatal 
error if not tightly controlled. 

2m Background NAxing: Allowing a NAX to be 
received in response to a background issued I/O 
instruction is possible* but tricky to program 
(see section 3.3.I.I.I.) 


3. Use of a non-addressab1e interrupt handler. 
Allowing an interrupt-response to a device 
whose handler address is not on the auto-exec 
reserve area is not permitted. 


Several machine instructions 
mask and unmask* QS3j FN8* I0R 
instructions. Each of these 
sections. 


are inherently auto-exec: the CIO 
* WAIT and the RIG/WIO input-output 
are described in the following 


CIO: Ma sk/Unmas k Controller 


Each device that can 
that mask and unmask 


cause an interrupt has a set of CIO commands 
the device^ controller. 


Unmasking a controller enables that device to issue an interrupt 
upon transition from a not ready to a ready state. Each device 
must be unmasked if it is to issue an interrupt from the 
auto-exec foreground. 


Masking a _controller prevents that device from issuing an 
interrupt signal* However* masking does not generally cle 3 r an 
interrupt. It remains pending until an IOR instruction is issued* 
a power down* or until the device is unmasked and the interrupt 
occurs. 


3*2.2. DS3/ENS Interrupts 


DSB 

from 

ALL 


disables places the TPU in a mode which prevents interrupts 
occuring* Th is instruction* as opposed to a mask* prevents 
evices from issuing an interrupt. One use of DS8 is to 
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m^y ab c^e S fore9rou " d s ? that 1/0 instructions, which 

! = . u“! e interrupts, can be issued in background 
straightforward manner® This is explained further in 


m a 
sect ion 


^ e "^ bl ! S al ' interrupts. Thus, this instruction, together with 
* _ . ° r r e sponjins device unmask instruction, must be issued at 
least once if interrupts are to cause normal auto-exec action. 

7 ' S ’ nitiatizedi the Program is not required to 
issue 0SB/-N8 instructions. Auto-exec automatically issues these 
instructions as a result of an interrupt or NAK signal, or an 

In addition, the DOS and PO/FMS loaders pass control to the 
applications program with interrupts enabled, but all devices 
masked. This is equivalent to having the loaded program execute a 


3.2.3. 


IOR 


The i:0R instruction dears any pending interrupts, and causes the 
controllers for the peripheral devices 
states® The instruction disables ail 
devices* 


to enter their reset 
interrupts and masks all 


Note 


Programs running under DOS or PD/FHS must not issue an IOR 
instruction! The DOS and PQ/FMS loaders set the 
controllers and TPU before passing control to the loaded 
program. in addition* the IOR instruction causes 
ccmatibihty problems with DOSLIS and FMSLIB routines. 


3 . 2 . 4 ! 


wait 


This instruction enables interrupts and causes the TPU to wait. 
No instructions are executed until an ‘ 

interrupt causes normal auto-exec action. When a NAK signal is 
the instruction following the WAIT " 


issued* 


interrupt occurs. An 
is executed. 


A typical use of this instruction is to establish a scan loop cl 

?h 0 °f° Sram “ here UAIT is the last instruction of the 

s9a "‘ J 0< ? c must * m general, be executed disabled. Otherwise, 

race conditions could cause the program to remain in the wait 
state overly long or indefinitely. 
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3*3* Auto-Fxec Initialization 


The software must make the initial entries into the background 
auto-exec area and must ensure that interrupts are disabled 
before the foreground task is started* in addition* it is the 
softwares responsibility to unmask all interrupting devices and 
to start up the initial foreground task handler* 

Consider, a routine which uses the RTC to count the oassing 
seconds in the keyboard lights and which computes the value of PI 
when the R TC is not interrupting* 

We code the initialization as follows: 

Disable Interrupts 
Unmask RTC 

Set location of background task 
and store into Background area 
Start up clock task 

After initializing the auto-exec and starting the foreground 
task* the remainder of the processing is handled by the 

pmK e 2nd , C Lm« th8t remains thenj is t0 code the tuo routines 


DSB 


CIO 

1*15 

LDC 

=PITSK 

ST C 

X ' 7F F A * 

JM P 

CLTSK 


CLTSK 

JSR 

RTC 


JM P 

CLTSK 

PITS* 

JSR 

PI 


JM P 

pitsk 


Subroutine to count seconds 
Keep looping until RTC NAKs 

Compute Pi 

Hang in background loop 


3*3* 1»1 * Background Processing 


* f 0 !] 1 C° l , technique commonly used in the background program is 

L ? 0p ,! lj ? the ^ Lo °P technique* the last instruction 

executed m background before the loop proceeds* is a WAIT 
instruction* The loop does net resume until auto-exec returns 
control from a n interrupt handler. The loop can consist of* for 
example* a scan of certain program flags* 

There are several control techniques which do not utilize the 
_ instruction* or example* a continuous scan loop might 
onsist of a task control block ring upon which a number of tasks 
are queued. The RTC can be used to make certain each task has an 

^!rh,!, 4 0 , C !»° rtt TH- t0 fce seruiced * The actual algorithms used in 
te hniques of this type are quite complicated and beyond the 

scope of this discussion* the programmer is urged to consult the 
abundance of literature on the subject* 
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3*3*1*1«1* Background NAXing 


To avoid background NAKing, the appropriate TIO, device busy or 
not rea^y, may be used in background I/O processing* 

JrACK 4,2,$ Keyboard input ready? • 

RIO 1,2 Read Key 

However^ i n many instances it is necessary to temporarily enter 
the foreground sc that background I/O can be processed* For 
example, D0SLI3 routines are designed to be used in background, 
with interrupts enabled. Many devices used by DOSLIB do net have 

n^ W TF PP r? P r 1a ^ c ent rc I 1 e r busy TIC. Thus, there is a routine. 
DacNTr, that allows foreground processing of code* 

This routine establishes a temporary background hang loop for the 
auto-exec so that I/O instructions that normally would cause a 
background MAX can be issued* Interrupts are disabled* Code 
executed in this temporary foreground will held up other 
foreground tasks* Thus, interrupts must be enabled as scon as 
possible after the code is processed* 


example cf the coding involved in a routine such as 
DuNTFj the reader is referred to the source listing of DOSLIB* 


3*3*1*2* r xecution Time 


The execution time of an RIO or WIO instruction is affected as 
to llows J 

Execution time is 1*6 microseconds if the device acknowledges* 
Otherwise, execution of the background task continues until an 
interrupt occurs* There is a 8.0 microsecond overhead before 
execution of the foreground I/O task commences* 


3*3*1*3* Default Condition 


A default condition exists if an 
address an empty controller 
situation and stores the ACR, 
stateword located at FFG * 


RI0/WI0 instruction attempts to 
slot* Auto-ex ec detects this 
PCR and CSR in the default 


Auto-exec then sets the ACR,PCR and 
and excution continues there* 


CSR from the background area 
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4* Refresh Subsystem Programming 


The refresh subsystem interfaces the display terminals with the 
refresh memory and the Read Only Memory (ROM) character 
generator* There are up to 2 (standard with a Dual 1920 
configuration) MOS Random Access Memory modules of ?G48 bytes 
each which Contain alI the memory necessary for the refresh 
subsytem* 


4*1* I/O Command Set 


For programming purposes the refresh subsystem is treated as if 
it were a peripheral device and is always referenced as device 
address 8* 

The commands that are used to control the refresh subsystem are* 
Control I/O commands (CI0 )j Read I/O commands (RIO)j Write I/O 
commands CWIO and Test I/O commands (TIO )• Each of the commands 
are summarized in table 4-1 and given a more thorough treatment 
in the followinc discussions* 
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Table 4-1 Refresh Instruction Set 


Function 
Code 

CIO 

RIO 

WIO 

Write Data; 
No Change 

P re-f et ch 

TIO 

0 ,8 

Mode 

Select 

R ead Da ta 

No Chance 

P re-f et ch 

1,8 

Enab1e 

Read Data; 

write Data 



Cu rsor 

Inc Address 

Inc Address 

__— 



P re-f et ch 

Pre-fetch 


2,8 

Disable 

Read Data : 

Write Data 

R ef resh 


Cursor 

Dec Address 

Dec Address 

Busy? 



Pre-fetch : 

P re-f et ch 


3,3 

Load 

« 

« 

R ead : 




MPR 

MPR : 




Lsb 

Lsb : 




Lead 

• 

• 

R ead : 



4,,3 

MPR 

MPR 




Msb 

Msb : 





t 
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Function 

Code 

CIO 

RIO 

WIO : Tio 

5,8 

Reset: 

Os b Cursor, 

R ead 



Se 1 Scrn 0, 
Turn off 

Sc rn Dsp ly 

• ••*»»8***» 

P re-f et ch 


6,8 



- . - 

7,8 

Se1ect 
Screen 

- — 

—————— ; 





8,8 



s Refresh 

- ; Present 

: (ACK) 
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Figure 4-1 

SPD 10/25 Refresh Subsystem 


To Be Supplied 
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4.2. 


Functional Description 


The basic structure of the refresh subsystem is shown in figure 
4-1* Addressing any one of the possible 2 (960 character* 2K 
hajf-screen mode) display stations* and transmitting the 
information to be displayed at the stations is under complete 
program control* The display stations are tied directly to the 
Memory Pointer Register (MPR )• The desired display is addressed 
by setting the appropriate bit pairs in the MPR * Information can 
then be written tc or read from the currently selected screen 
memory by selecting one of the WI0/RI0 C* WIQ/RIO 1* or VI0/RI0 2 
instructions* The MPR points to a specific location in the 
screen 1 s RAM s which determines where on the screen the data is tc 
be displayed* Characters in the RAM are painted onto the selected 
screen by a procedure called refreshing* The hardware implements 
this by automatically loading internal line buffers in 
preparation for the refreshing process* 

Screens are divided into screen pairs* For the full screen Dual 
1920 configuration* (2 screens with 30 lines of 64 characters or 
2 screens with 25 lines of 8G characters)* each display pair 
screen has its own refresh memory bank* There is* in addition tc 
the 1920/2000 dispiayable character area (30 X 64 = 1920 80 X 25 
= 2000)* a 128/48 character buffer immediately following the 

screen's refresh ares in the refresh memory bank* Although 
undi sp I ayable* this buffer is available tc the software program* 
making the total individual screen area in this mode to be 1920 + 
128 = 2048 or 2Q0C + 48 » 2048 characters* 

For the half-screen configuration* there is a 960 character 
dispiayable area for each of the possible 4 screens* each of the 
2 memory banks is shared by two display screens* In this mode* 
the screens can have either 12 lines of 80 characters or 15 lines 
of 64 characters* There is a 64 character non—disp1ayable buffer 
immediately following each screen's refresh area which is 
available to the software program* making the total individual 
screen ref resh area to be 960 + 64 = 1024 characters* 

Since 1 or 2 memory banks may be installed depending upon the 

system's configurations* it is possible to attempt to reference 
non-insta1 ! ed memory by selecting and either reading from or 

writing tc the banks associated with the non-instalIed memory* 
Any attempt to read via those banks will yield a zero in the ACR* 

When the TPU is initially powered-on* all screens and the cursor 
are disabled* The first CIO Select command enables all screens* 
There is no pcwer-save function for the refresh memory banks* 
Therefore* when the system is turned on* all screen memories will 
contain random data* 

There is no »End-cf-Data' attribute* and therefore* the entire 
2000/1920/960 character positions on the screen must be 
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dispiayed. 


Centering* cr otherwise manipulating and editing data on the 
display sc re en* is completely under the control of the software 
program and is accomplished by merely placing the necessary data 
in the appropriate locations within the screen's refresh memory 
area* 


4.3. Refresh Eusy Condition 


While the refresh subsystem is sutomati ca I l y loading the line 
buffers in preparation for refreshing the display screens) 
refresh is considered 'busy'. While the iine buffers are being 
loaded, the following I/O instructions should not be used as they 
will be totally ignored by the TPU Ca Command-Reject condition is 
said to have occured): 


* CIO 1 Enable Cursor 

* CIO 2 Disable Cursor 

* WIO 0 Write 


* WIO 1 Write Increment 

* WIO 2 Write Decrement 

* RIO 0 Read 


* RIO 1 Read Increment 

* R 10 2 Read Decrement 

* RIO 5 Read Pre-Fetch 


4.3.1. TIO 2j Refresh Busy Command 


To determine if a refresh busy condition exists* a TIO 2 (Refresh 
Busy) command may be used. However* the TIO Refresh Susy command 
wifi actually acknowledge that refresh is busy 14 TPU cycles 
(22.4 microseconds) before the line buffers begin to be loaded. 
./ re> , 1 ^ r ^ resil 1S not busy* there is always at least 

14 C, U eye ies in which I/O instructions can be executed before 
the refresh becomes busy* Loading cf the line buffers requires 
\\ microseccnds* The TIO 2* Refresh Busy* tests for a total of 
‘ . + -2 = 150 1 m ic rcseconds. Although refresh is busy for 15C 

microsecondsj the command reject condition applies only to the 
128 microseconds required for loading the line buffers. 
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The JTACK instruction should be the TIO 2 used to test for a 
refresh busy condition# Use of the JFACK instruction does not 
guarantee valid I/C processing# Interrupts are enabled when a TIO 
instruction causes a jump# Therefore* it is possible that an 
interrupt could occur if a branch to a refresh I/O request is 
caused by the JFACK instruction# If this happens* there would be 
no guarantee that the refresh would be ready upon the return from 
the interrupt processing* However* a JTAcK instruction jumps only 
when refresh is busy* thus ensuring that interrupts will be 
disabled during the I/O request# 

The following code is recommended for testing a refresh busy 
conditions 


JTACK 2*8*$ Refresh Susy? 

WIC3 0*9 Write Data Into RAM 


If a non I/O instruction is required after the JTACK* but 
preceding the I/O instruction* a DS8 must be used to disable 
interrupts with a subsequent EN'B after the last I/O instruction. 


4*3*2# Cursor Enabled Mode 


When the cursor is enabled* the execution cf the leaded program 
is slowed by 29*?%« This is the time required for the refresh 
subsystem to make comparisons with the CUR and display the cursor 
at the proper location* These comparisons do not add to refresh 
time* but cause program execution time loss* 

When the cursor is enabled* the following occur: 

* The program is suspended during refresh* 

* Auto-exec is halted during refresh* 

and* 

* TIO 2 * Refresh Busy* is MOT necessary before any 
instruction except a CIO 1* Cursor Enable* and CIO 
2* Cursor Disable* 

When the cursor is disabled* program exection time returns to 
normal* auto-exec time returns to normal* and TIO 2 instructions 
must be issued where appropriate* 
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4*4* CIO 5* Command Reset 


This command is equivalent to an I OR except that its effect is 
limited to the refresh subsystem* The CIO 5 instructions 

* Disables the cursor j 

* Selects screen 0 for cursor display 

* Causes the video to ail screens to be turned off* 
The screen data memory is unmodified* 


4*5* Attribute Characters 


Attribute characters are n on-p ri nt ab I e control codes which define 
the characterist i cs of the display field that follows* Hardware 
controlled conditions include two levels of brightness (normal 
and high intensity)* field blinking* and blanking* The field is 
defined as the attribute character position plus all the data 
following it up until the next attribute character or the end of 
the screen if no attribute character follows* 

The effect of an attribute* however* doesn*t wrap from the end of 
the screen ^ back to the start of the screen® The attribute 
character itself is not normally displayabie* but with an 
available system option* the software can allow the attribute 
character to be displayed as a vertical line (1) character at the 
attribute character position* When displayed* the vertical line 
is subject to the same parameters the attribute character 
specified* such as brightness* blinking* cr blanking* Fach time a 
character in the screen memory equal to or greater than Hex SO is 
detected* the refresh subsystem will consider it to be an 
attribute character and all the following alphanumeric characters 
will be modified aporopriateIy, 

Blinking is performed at the rate of 1*S6 cycles per second and 
may be done in either normal or high intensity mode* At the first 
position of the display* the screen is always unblanked* 
non-blinking* and normal intensity* since a character can not be 
placed before it* The format for the specification of an 
attribute is given below: 


4 -8 



F nt ry In R e-fresh R AW Byte? 


J 6 5 v 4 ■ 3 . 2 1 . 0 

* f Protect! i 0 Normal 0 I iField 

1 Attrib! Blink! Marker l Numericl 0 Inten 1 INot iModif 

Cher J I I I + --———+Usedl *** 

+ —+ -+-+ 1 High 0 j -- 

Oats I No_ i Un- I Alpha- +--+ INot 


+ —+ -+-+ 1 High 0 j -- 

Oats I No_ i Un- I Alpha- +---+ INot 

0 Char I. Blink! Prctectl Numeric! 1 Blank 1 I IModif 



xxxNote: Software convention bits may be tested or set by 

program for the conditions (arbitrary) indicated* 


4*6* Screen Initia l ization 


Before a n y operation on the refresh subsystem can be performed* 
the program must issue certain initialization commands to 
configure the subsystem into a known mode and to specify to which 
screen the I/O operations are to be performed and the cursor 
displayed* These are the functions of the CIO 0* Node Select* and 
CIO 7* Screen Select commands* which are described in the 
following sections* 


4*6*1* CIO 0* Mode Select Command 


! he . functions of the bit values are as fellows* Bit zero 
indicates whether the system has up to four screens of 960 
characters each or up tc two screens of 1920/2000 characters 
each* 

Bit 1 indicates if the system is to have an SO character line or 
a 64 character line* Sit 2 indicates if the Protect Field Marker 
is enabled or disabled* This bit allows or inhibits the 
displaying of a vertical slash (I) where an attribute protected 
field code exists* except when the code indicates blanking* 

Bit 3 indicates if the visible attribute character actions* 
blinking* blanking* and high intensity tc be either enabled or 
disabled* If these attribute activities are disabled* then the 
attribute code bits may be used as software fiao; that screen 
position will be blanked* 

Bit 4 specifies execution of the Bisync cyclic check function if 
U or PARS cyclic check if G. The cyclic check generator is 
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described in section 8. Bit 5 through 7 are not used. 

When the system is initially powered-upj the refresh subsystem is 
not in a known mode* AdditionaIiy* the current mode cannot be 
sensed by the software program* Therefore., the mode select 
instruction* CIO G* must be issued by the program at least once 
to configure the system into a known modem 

81T * 

7-5 4 3 2 1 0 

- - - - ---+ --+- 

_ 1 . 1 l l I 

1 Not I Bisync ! DS B I EN5 180 IHalf 

Used l Cyclic Check 1 Attribute l Field Marker 1Cha risereen 

- _+ ,—- +--+ — - 

1 PARS . | EN5 I DS3 164 I Fu l l 

0 I Cyclic Check I Attribute l Field Marker ICharlScreen 

—+ ———- -+-—--+-+- 


4*6*2* CIO 7* Screen Select Command 


The refresh subsystem contains 1 cursor register. Since there may 
be up to four screens* this instruction is used to specify on 
which screen pair the cursor will be displayed* 


Once a screen pair has been selected* ail subsequent cursor 
commands will be directed to that pair. To direct a cursor 
command to a screen pair other than the one currently selected* 
it is necessary to issue a new select command tc the desired 
pair* A one cycle delay Cl.6 microseconds) is required between 
successive CIO 7 Select and/or IOR commands. A NOP instruction 
can be used tc wait cut the one cycle delay. The issuance of 
either a CIO Reset or an IOR resets the selected screen to 0. 
Cursor values are not changed by either one of these 
instructions* The value in the ACR at the time the select command 
is executed defines the selected pair as shewn below* 



7 

+— 

5 


4 


3 

0 

0 

J 

-1 Not 

l 

Used 

i 

S c reen 

0 

i 

--+ Net 

1 

l 

Used 1 

1 

1 

i 

-+ - 

S creen 

1 


Cursor display cn a particular screen within a screen pair is 
determined by the range of RAM memory addresses set in the CHR* 
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In the ful l screen mcde ALL of a RAH oiensory module is dedicated 
to a partKuar screens and their a re no screen 'pairs 1 # 

In the half screen mode* each RAM can address both screens of a 
particular screen pair* This is illustrated in table 4-2* 


Tabis 4~2 CUR and RAM Screen Addresses 


Screen Cnfg 1 screen Pair I Screen 1 RAM Range ! CUR Range I 

+ +— -- + - - --- - 

1 I I I I 

Full 1920/ | 0 1—1 0000-G7FF | 0000-G7FF 1 

2000 I }| | | 

1 1 I — I 1G‘CO-17FF 1 0000-07FF I 

--+-- 

I I I 

0 i QGGG-03FF I 00C0-03FF 1 

1 I 04G0-G 7FF I G4CQ-G 7FF. } 

I I I 

0 I 1000—13FF i G0C0-G3FF I 

1 I 1400-1 7FF I 0400-0 7FF } 


Half 96C 1 0 | 

I 1 I 


4*7# CIO 1/2 Enable/Disable Cursor 


The determination as to whether the cursor is to be visible on 
the screens is programmable via the CIO 1* Enable or CIO 2 * 
Disable Cursor command. These commands do not affect the data 
displayed on the screen. When the cursor is enabled* it slows 
program execution by 29*3% (see section 4*3*2.). 

The cursor is a rectangular blob which may be positioned anywhere 
on the display, when positioned ever a character* it obliterates 
it but does not wipe it from the RAM. It should be noted that the 

position of the cursor is completely unrelated to the positions 
of data in the RAM. 

Since the CUR is frequently used as a 12-bit data register* it is 
a good idea to limit non-display usage, when the cursor is 
enabled* to prevent 'ghost' cursors from haunting the screen. 

u ths curscr ®ust be disabled* or only off-screen values 
should be loaded. 
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4*8* Setting the Cursor 


The cursor is set by leading the CUR with the desired display 
position* If the display is operating in 64 char/line mode* the 
LIR field corresponds to the line position and the CHR 
corresponds to tne character position where the cursor will be 
displayed* within the screen pair selected by the CIO 7* Select 
Screen* instruction* See table 4—2 fGr the address range of the 
particular screen* within the selected screen pair* on which the 
cursor wili be positioned* 

If the refresh is operating in the 80 char/line mode* an absolute 
address must be calculated and loaded into the CUR to position 
the cursor to a relative line/column location* 

This is achieved as followss 

* Select the screen" pair on which the cursor is is 
tc be displayed via the CIO 7 instruction* (in 4K 
RAM configurations only*. i*e.* Dual 1920) 

* Select the starting address of the screen within 
the screen pair on which the cursor is to be 
displayed* This will be the base used in the 
ca i cu l at ion (for e xa nip le* X 1 040 0 * is the starting 
address of screen 1* OGGC is the starting address 
of screen 0)* 

* Compute the absolute CUR location corresponding 
tc the given line/character (where line/char are 
numbered from 1 ) : 

Ease + 8C X (line) + (char) = CUR setting 

Tc cause the cursor tc appear on screen 1 of screen pair 0* in a 
half-screen configuration* at char position 5* line position 2* 
the following is coded: 

LDI X^O* Select screen G 

CIO 7* 8 xxx ■ 

LDC =80x(?)+(5)+X 1 4 00 1 Compute absolute position 
JTACK 2*8*$ Wait for refresh 

CIG 1*8 Enable cursor 
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The CUR is a 12-bit register in.the foilowing formats 

+ -—■—+ - —~- - -—+-- - —- 

0 ! Enb I | 

~ +- + LIR l CHR 

1 I Dsb I i 

+ ------ — -- 

11 TO 65 

Bits 0 thr ou gh 10 contain the absolute vs l u e of the cy rs or within 
its own refresh memory area* Legal values are 000 through Hex 7FF 

for 1920 character per screen configurations* and Hex COO through 

Hex 3FF and Hex 0400 through Hex 7FF for 960 character per screen 
ccnfigurations• 

Bit 11 is the enabIe/disafcIe bit. If bit 11 is a 1* the cursor is 
displayed at an address greater than- the the legal value (e .g • 
e ectively disabled) If bit 11 is a 0* the cursor is can 

reference a legal address and is effectively enabled. This is an 
alternative to issuing a CIO 1/2* EnabIe/Disab1e cursor 

instruction* though the actual mechanism is different* 

The cursor may be manipulated with the following instruct ions : 


INC 

tc 

Increment cursor 

by one 

in2 : 

1C 

Increment cursor 

by two 

DEC 

sc 

Decrement cursor 


ML A 


Move LIR to ACR 


MAL 


Move ACR tc LIR 


MCA 


Move CHR to ACR 


MAC 


Move ACR to CHR 


CLC 


C1 ear CHR tc Q 


CL L 


Clear LIR to 0 



Note uhat the HAL* MLA* MCA* MAC* CLL* and CLC instructions* in 
64 char/ime full screen mode* act correspondingly on the line 
and character position of the cursor* 


4*9. Setting the MPR 


The MPR is a 16 bit register used to determine the screen 
location of displayed characters. In the 64 char/line mode* the 
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MPR is set to an absolute address within the screen RAMj unlike 
the CUR register which employs iine/char addressing. 

In 80 character modej the ROM converter (described in section 5,) 
can be used tc set the MPR cn a iine/char basis® This is the ONLY 
instance when the MPR is set this way* 

Two instructions are used to set the MPR, They are the CIO 3 and 
CIO 4 instructions and set the MPR Lsb and Msb 8 bits 
respective ly • 


4,9,1, CIO 4: Set MPR Msb 


This instruction transfers the contents of the ACR to the 8 Msb 
cf the MPR, when addressing Full screen (1920/2000) 
configurations the MPR M s b has the following format: 


.+ -- — +-■ - + - + - - 

I I Screen 1 l 1 

0 i N ot l Pair 0 l I I 

--+ Used +---+ 0 j ram Address i 

1 I I Screen I i \ 

l I Pair II l j 

+--+ --.-+-+--- + 

7 5 4 3 2 0 


Bit 5 through 7 are net used. Bit 4 gives RAM addresses greater 
than 7FF when or. (these are addresses in screen pair 1), 

Bit 3 is set effj and bits G through 2 give the address of a 
location within a screen pair, 

When addressing half —screen (960 j configurations j the following 
format is used: 


+- - — - + ---+ -+--+ 

I l Screen l I S creen I i 

0 I Not l Pair 0 i f Q | Rah l 

—+ +-+ 0 +-+ Add r* I 

1 Usee l Screen I i Screen I \ 

II I Pair II I 1 i I 

----+- * --+—- + 

7 5 4 3 2 1 0 

Bits 5 through ( are not used. Bit 4 al lows addresses greater 
than 7FF when on j thus selecting screen pair 1, Bit 3 is set tc 
°* Bi ^ 2 allows addresses greater than 3FF when onj thus 
selecting a screen within the screen pair* 

Bits 0 through 1 give the Msb address of a location within a 
selected screen. 
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This instruction moves the contents of the ACR to the 8 Lsb of 

the MPR* The MPR Lsb has the same format regardless of 
configuration^ 



I RAM Address! 8 Lsb I 


4«9*3* Using the CUR to Set the MPR 


Ordinarily* setting the MPR on an absolute basis requires the 
programmer to trcnslate s iine/char address in a manner similar 
to that described in section 4*8* for the CUR* However* in many 
64 char/line applications* the CUR can be used to set the MPR on 
a Iine/char basis* This requires that the CUR be dedicated to 
this purpose* or some mechanism for saving the contents of the 
CUR be provided* 


The call of the subroutine is* 


JSR SETMPR 

Ent rys (CUR ) CHR 

: Character position 



LIR 

: Line position 



(ACR ) 

Irre 1 event 



Exit: (ACR ): 

D.est rcyed 



(CUR ): 

Saved 

SETMPR 0AC 

** 

Save return point 

STC 

WORK 

Store Cursor 

contents at work loc 

LD 

VORK+1 

Load ACR with 

Lsb 

CIO 

3*8 

Set MPR Lsb 


LD 

WORK 

Load ACR with 

Msb 

CIO 

4*8 

Set Mpr Msb 


JMP* 

SETMPR 

Return to caller 

WORK DAC 

X* 

Location used 

to set MPR 


4*10* Write I/O Commands 

The Write I/O commands and their functions are described in the 




following sections* 


4*10*1* WIO 0 Write Data! No Address Change 


This command causes the data in the ACR to be written to the 
currently selected screen's refresh memory at the current MPR 
address. If this address is within the screen's dispiayafcle 
refresh aresj is not within a blanking attribute protected field 
and if the screens are enabled* then the character will also be 
displayed on the selected screen* The MPR address remains 
unchanged after execution of the instruction! it is left pointing 
to the address of the last written character* This command is 
always acknowledged but will be ignored during a refresh-busy 
condition* 

A one cycle delay is required between successive WIO G and/or RIO 
Oj RIO 1j RIO 2* RIO 5j WIO 1 and WIO 2 commands* A NOP 
instruction may be used to wait out the required delay* 

After the data is written to the screen’s RAM* a read cycle is 
performed at the address contained within the MPR* This is 
equivalent to a program-issued RIO 5* Read Pre- Fetch 
instruction* 


4*10*2, WIO 1 Write 03tai Increment Address 


This command functions in the same manner as the WIO G command 
(descibed in section 4*10*1.) except that the MPR address is 
incremented by one following execution of the instruction* 

Therefore* the MPR address is left pointing to one position 

beyond the last written character* A one cycle delay Cl.6 

microseconds) is required between two successive WIO 1 and/or RIO 
0*RIG Is RIO 2s RIO 5s WIO Qor WIO 2 commands* A NOP is 

inserted between the instruction pairs to wait out the one cycle 
delay* The WIO 1 command must not be issued while a refresh-busy 
condition exists* A read pre-fetch is performed at the address 
contained in the MPR after the intruction has been executed* 


4*10*3* WIO 2 Write Data* Decrement Address 


This command is similar to the WIO 1 command except that the MPR 
address is decremented by one following execution of the 
instruction* The MPR is left pointing to the address immediately 
preceding the last written character* 

A one cycle (1*6 mic ro seconds) delay is r equ ired bet ween t wo 
successive WIO 2 and/or RIO 0* RIO Is RIO 2* RIO 5* WIO 0 or WIO 
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1 commands* A read pre-fetch is performed at the address 
contained in the MPR* after the instruction has been executed* 
This instruction must not be issued while a refresh-busy 
condition exists* 


4*11* Reed I/O Commands 


The Read I/O commands and their functions are described in the 
following sections* 


4*11*1* RIO 0 Read oatai No Address Change 


This command is always acknowledged but may net be issued while a 
refresh-busy condition exists* This command causes the controller 
to transfer data from the currently selected screen at the 
current cursor location to the ACR* The cursor address is not 
changed upon completion of the instruction* 

This command must be immediately preceded by a RIO 5 Read 
Pre-Fetch Command (described in section 4*11*4*) if the data read 
is to be valid* This pre-fetch loads a buffer register with the 
data to be transferred* The data is loaded into the ACR from the 
buffer by the RIO Read Data commands* 

After this instruction has been exectued* a read pre-fetch is 
automaticaily issued at the address contained in the MPR * This 
eliminates the necessity for issuing RIO 5* Read Pre-fetch 
commands when performing consecutive reads* 

This instruction requires a 1 cycle delay between successive RIO 
0 and/or RIO 1, RIO 2* RIO 5j WIG 0, VIO 1 and WIO 2 commands. 


4*11*2* RIO 1 Read Data* Increment Address 


This command is similar to the RIO 0 command in that it must not 
be issued during refresh-busy and must be preceded by a RIO 5 
Read Pre-Fetch to validate the data being read. In addition* a 
one cycle delay is required between two successive RIO 1 and/or 
RIO 0* RIO 2* RIO 5* WIO 0 WIO 1 or WIO 2 commands* 

After execution of the RIO 1 command* the MPR is incremented by 
one and is left pointing to the address immediately following the 
character^read * This command may be used for the sole purpose of 
incrementing the MPR* and when used for such* need not be 
preceded by a RIO 5 Read Pre-Fetch command* No valid data can be 
read under this condition* 
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Aft^r excut ion cf this instruction* an automatic read-prefetch is 
executed which makes it unecessary to issue a RIO 5 command 
be.ore the next consecutive read or write instruction* 


4*11*3* RIO 2 Read Data* Decrement Address 


This command is similar to the RIO 1 command* It must be preceded 
by a RIO 5 Read Pre-Fetch to validate the data being read* must 
not be issued during refresh-busy* and must not be issued without 
a 1 cycle delay after the last RIO 2 and/cr RIO 0* RIO 1* RIO 5* 
U'lO 0 W10 1 or VIQ 2 instruction* After execution of the 
instructions the MPR is decremented and is left pointing to the 
position immediately preceding the address of the character read. 
The RIO 2 instruction can be used for the sole purpose of 
decrementing the cursorj and when used for such* need not be 
preceded by a RIO 5 Read Pre—Fetch instruction# 

After execution of this instruction* an automatic RIO 5* Read 
Pre-fetch instruction is issued* 


4*11*4* RIO 5 Read Pre-Fetch 


This commend initiates a data read from* the currently selected 
screen at the current cursor address. It loads a buffer in 
preparation for the RIO 0* I or 2 commands which fetch the data 
from the buffer and transmit it to the ACR* The RIO 5 command may 
not be issued during refresh* It must be issued exactly 1 cycle 
cu / microseconds) before an RIO 0* RIO 1 or RIO 2 if the data 
beino read is to be^ valid. This command is only necessary to 
validate the data being read* and need not be issued if the RIO 1 
or RIO 2 command is oeing used simply to position the MPR « 

The WIG 0* */I0 1 j UC 2* RIO Oj RIO 1 and RIO 2 auto mat i ca 1 j y 
prefetch data from the HPR setting after the instruction has been 
executed. Therefore* if a read is to be performed immediately 
after executing one of the above instructions* a RIO 5 command is 
not required. 

Note that the automatic pre-fetch cycle is valid only if the 
address of the MPR i s not changed by a CIO 3 or CIO 4 command. 
One use of this feature would be to read data 
from a particular screen field. 
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A subroutine to imp!ement this is s 


JSR RDFLD (MPR) Set to the beginning of field 

DAC SUFFER CACR) Length of field 


BUFFER Pointer to a location to store field 


RDFLD 


LOOP 


WORK 

CTR 


DAC 

XX 

ST 

CTR +1 

LDx 

RDRLO 

ST 

WORK 

INC 

RDFLD 

LDx 

RDFLD 

ST 

V0RK + 1 

INC 

R D r LD 

RIO 

5*8 

RIO 

1*8 

STx 

WORK 

DEC 

CTR 

JCGT 

LOOP 

JM Px 

R 0 r LD 


DAC 

XX 

WORD 

XX 


Save parameter address 
Counter for length of field 
Area tc place read field 
xxx 

Bump return to next byte 
* xx 

XXX 

Bump return past parameters 

Required pre-fetch 

Read dataj inc address* pre-fetch 

Store in supplied buffer 

Check for end of field 

Continue reading if not at end 

Else* return to caller 


Address of buffer 
Counter for loop control 


4*11*5* Ref resh Size 


For 64 character per line configurations* the total refresh 
memory size of either 2048 or 1024 is an exact multiple of 64* In 
192C character configurations* the total screen memory size of 
2048 permits 30 full lines of 64 characters in the displayable 
refresh memory and ? full lines of 64 characters in the buffer 
area as shown in figure 4-2a• 
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Figure 4-?a 
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Figure 4-2b 
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Fu I I S c reen 


2000 Char 
Displayable 
Ref resh 
Hemery 


43 Char 
Buffer 
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figure 4-2d 


- --—-- ••»»••«•••••••• 

l i 

Line 010 79 l 

1 - . i v v' 

* I 960 Char 

Line 1 l 0 v 79 i Displayable 

* 1 Ref resh 

+ -- + Memory 

» i 

i 7 

+ - - 

t i 

Line 11 f 0 79 ] 

* 1 

- -— — - +---— + 

I I 

Line 12 I Q 63 l 64 Char 

J ! Buffer 


80 Char/Line 
Half Screen 


In ha 1f-screen* 960 character display* systems* the total screen 
me me ry size c f 1 024 permits 15 full lines of 64 characters in the 
di so i a ya b 1 e refresh memory and 1 full line in the refresh memory 
buffer area (See Figure 4-2b)* However* in 80 character 
configurations* the total refresh memory size of 2000 or 1024 is 
not an exact multiple of SO* Therefore* in full 2C00 character 
display systeras* the total screen memory size of 2048 permits 25 
full lines of 80 characters in the displayable refresh memory* 
and one partial line of 4S characters in the refresh memory 
buffer area (Figure 4-2c)» 

In half-screen 960 character configurations* the total screen 
mercery size of 1024 permits 12 full lines of SO characters in the 
displayable refresh memory and one partial line of 64 characters 
in the refresh memory buffer area (Figure 4-2d)* 


4*11»6» RIO 3 Read MPR Lsb 


This command is always acknowledged and may be issued at any 
time*with 64 character per line configurations* The 3 Lsb of the 
MPR are transferred to the ACR in the same manner as described 
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for the CIO 3 command in section 4.9.2*. 


4*11 * 7. RIO 4 Read Line 


This command is the same .as the RIO 3 command except that the 8 
hsb of the HPR are transferred to the ACR in the same format 
described in section 4.9.1. for the CIO 4 Command. 


4*12. Illegal Line/Character References 


In a}1 64 character per iine configurations and in 80 character 
per line configurations employing absolute addressing* it is 
impossible to attempt to reference an illegal screen memory 
location. 

However* in 80 character per line configurations* when addressing 
memory using_ the line/character address mode* (ROM Code 
• Converter ), it is possible to attempt to reference an illegal 
character or an il legal line. In fuiI screen configurations* a 
character reference greater than 47 on line 26 is illegal. I n the 
half screen mode., a character reference greater than 63 on line 
12 is i I I ega I . 

In the line/char addressing mode* the hardware uses bits 0 
through 4 when loading the ROM in full screen configurations. 
This permits an attempt to reference up to 32 lines. the legal 
limit is 26 lines* In the half—screen mode* the hardware uses 
bits 0 through 3 of the ACR* permitting an attempt to reference 
up to 16 lines when the legai limit is 12. 

In addition* mode* when using Iine/character addressing* the line 
and character addresses are not directly tied to the HPR as they 
are in the 6m. character mode or in the absolute addressing mode. 
Instead* the values loaded into the line and character registers 
are converted to an absolute memory location by the hardware Read 
Only Memo ry (ROM) look -up table. If the ROH detects a 
line/character combination that would reference either an illegal 
line or character* that reference is converted by the ROM to a 
legal location in memory in accordance with the rules described 
below* and the line and character registers are updated to 
reflect the,new reference. 

The basic rules are as follows: 

1. For 200C character screen configurations* any character 
reference from character 48 through 79 inclusive on line 26* 
or any character greater than 79 on any line* or any line 
reference greater than 26 wil! be converted to one of the 
last 16 locations in the screen’s buffer (net disp I ayable). 
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yhich of the 16 locations is used depends cn the value of the 
least significant Hex digit in the character register at the 
time of the the illegal reference* (e*g* character reference 
= 4F: location used is set by FJ% 

2* For 960 character screen configurations » any character 
reference fircrr 64 through 79 inclusive on line 12 or any 
character reference greater than 79 on any line will be 
converted to one of the last 16 locations in the screen’s 
buffer memory (not disp1ayabIe). Which of the 16 locations is 
used is determined as described above* Any line reference 
greater than line 12 will be wrapped back up into the 
screen ’ s visible refresh memory area* 


Note: Because of the possibility that one of the 16 

locations of the buffer memory may be altered 
inadvert ant 1y by an ill ega I cha ra cter refer en ce * 
it is recommended that these 16 locations not be 
used by the software program in 80 character per 
line configurations when the I ine/character 
addressing mode is used* 


4*1"^* TIO 8: 10/25 System Identification 


This instruction is always Acknowledged in the 
used by the SPD/DGS nucleus tc distinguish the 
SPD 10/20 in DOS ’compatible* programs* 


SPD 10/25* It is 
SPD 10/25 from the 
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5• ROM Code Converter 


The ROM code converter function is contained in the refresh 
subsystem* It is addressed as device 8* The code converter 
implements a translate table look-up function utilizing 16*384 
bit static ROM* 

Eleven differnet tyoes of translate-tab Ies are available: 


1* 

Line/Char to Absolute 

(80 char/line 

on l y ) 

2. 

Absolute to Line/Char 

(8Q char/1ine 

on 1 y ) 

3. 

ASCII to EBCDIC 



4* 

EBCDIC to ASCII 



5* 

BCD to ASCII 



6. 

ASCII to BCD 

GeneraI Code 


7* 

BAUDOT to ASCII 

Conversion Tables 

8 

ASCII to Baudot 



9* 

Shift Right 4 



10* 

Rotate Right 1 



11. 

Decimal Multipiy • ••« 




In addition* definitive ROM addresses are given fcr all ASCII 
character representations* as shown in table 5-2* This table also 
shows the correspondence between ASCII and EBCDIC 
representations* 


5*1* Code Converter Instruction Set 


The input word tc be translated is loaded into the MPR via the 
CIO 3 and CIO 4 instructions* A CIO S instruction is then used to 
initiate the cede translation cycle* a one cycle delay is 
required before reading the translated data* The RIO 7 and RIG 8 
commands are used tc extract the translated data* 
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ROM Code Converter Instruction Set 


Fun ction 
Code 

: CIO 

• 

s RIO : 

: : 


Load MPR 


3 j 8 

8 Lsb 

- ■ : 

«**•••••« 




Load MPR 


4>- 

00 

8 Msb 

- : 



Read Code s 

7 j 8 


Converter s. 
LSS : 



i 

Read Code : 

8*8 

Execut e 

Converter J 


Cede Conversion 

■ MSB : 


Line/Charact?r to Absolute Translation 


This translation table yields the absolute RAM location of each 
Ime/cha ra ct er incut* The I ine/ch a ra cter designation is readily 
related to a physical point on the display screen while the data 
displayed at that point is a l wa ys stored in the M PR as a n 
obsolute address* This table simply yields the equivalent RAM 
address for each i ine/character position on the display screen. 
This translation is valid for SO character screen formats only. 
The MPR must remain unchanged until after the RIO 7 and RIO 8 
commands are issued for this table* 

The Iine/character to absolute translation data input format is 
shown below: 
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7 5 4 

I i 

10 0 01 
I I 

+-- 


Line 


§§§f|: 



0 

■ 4 *. 

7 

1 

i 

l 

1 

i 

0 1 

1 


l 

•+ 

+ - 

— •+ 


Ai 

CIO 4*8 


Character 

Bi 

CIO 3*8 


0 

•+ 

I 

i 

I 

+ 


Byte AI is stored in the MPR Msb via the CIO 4 instruction* Bits 
5 through 7 must be zero* The valid range of line values are 00 
through 1A hex* 

Byte Bi is stored in the MPR Lsb via the CIO 3 instruction. Bit 7 
must be 0* The valid range of character values are 00 throuah 4F 
hex* 


5*2*1* Output Data Formats Absolute 

After executing thp conversion* the data is stored in the MPR in 
this format s 


7 

+ . 

3 

2 

0 


1 

?? 

l 

1 

+ 

l 

1 

l 

Undefined 

I Msb 

1 

I 

? ? 

1 

1 

1 

+.- 

---— — - 

-+-——- 

—+ 

+ 


Lsb 


Ac 


0 
- + 

1 

I 

i 

+ 


Abso lute 
Data Field 


Bo 


Byte Ao (M s b> is transferred to the ACR via the RIO 8 command. 
Bits 3 through 7 are undefined and should be masked by the 
program* Bits 0 through 2 contain the three Msb of the absolute 
data field* 

Byte 8o (Lsb) is transferred to the ACR via the RIO 7 command. 
Byte So comprises the 8 Lsb of the absolute data field* 


5*2*2* Exa mpIe 


This example il lustrates the operation of 
Absolute Code converter* and of the ROM 
genera I • 


the Line/Char to 
Code Converter in 
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It is necessary to traslate any line/char position into an 
absolute position and set the MPR. The following subroutine is 
one possible solution* 


JSR SIMP R 

3YTF RowjCcI 

STMPR DAC ** 

LD * STMPR 
CIO 4*8 
INC STMPR 
LQ # STMPR 
INC STMPR 
CIO 3* 8 
CIO 8iS 
NOP 

RIO 8*3 
AN I X l 07* 
CIO 4*8 
RIO. 7*8 
CIO 3*8 
JMP* STMPR 


Parameter location 

Fetch row position 

Transfer to'MPR Msb 

Move to column position 

Fetch column position 

Bump return past parameter 

Transfer to MPR Lsb 

Execute Code Conversion 

Wait one required cycle 

Read Msb Code Converter Output 

Mask out garbage values 

Set MPR Msb 

Read Lsb Code Converter Output 
Set MPR Lsb 
Return to caller 


5*3* Absolute to Line/Char Traslation 


This translation table yields the line/character equivalent cf 
each absolute refresh RAM input* The purpose of this translation 
is to relate each absolute location of the screen RAM memory to 
the hne/charscter location on the screen at which that character 
is.dispI ay ed* 

This table is merely the inverse of the line/character to 
absolute translation described in section 5*2. and is valid for 
80 character/line serpen formats only. The MPR must remain 
unchanged until after the RJO 7 and RIO S commands are issued for 
this translation table* 


5*3*1* Input Data Format (Absolute) 


The absolute to 1 ine/character input data format is described as 
foI 1ows : 


5 -4 



7 5 4 3 2 

+-+- —. +- 

I ; -'V. I ’ i' 

1 0 Cl 10 0 I Msb 
I i t 

+ -+-+- 


8yte Ai is stored in the MPR Msb via the CIO 4 instruction* Bits 
3s 4 s 6s and 7 of byte Ai must be zero* Bit 5 must be one. Bits 0 
through 2 of byte Ai comprise the three Msb of the absolute data 
field* 

Byte 3i comprises the eight Lsb of the absolute data field* The 
range of the absolute data field is 00 through 07FF* 


5*3*2* Output Data Format (Line/Char) 


0 7 0 


1 I Lsb I 

I l I 



Absolute 
Data Field 


The output format of the ROM converter is as follows: 
7 5 4 0 7 6 


+ 

I 

?? 

1 


I 

Undefin ed 

I 

Line 

l 

4 » 

?? 

l 


A o 


H-h — ——— — — — — — — — — ——— 

I 1 

I ? I Character 

I I 

+ -- - - 

Bo 


+ 

l 

1 

I 

+ 


Byte Ao is transferred tc the ACR via the RIO 8 command* Bits 5 
through 7 of byte Ao are undefined and should be masked by the 
program* 


Byte Bo is transferred to the ACR via the RIG 7 command* Bit 7 of 
byte Bo is undefined and should be masked by the program* 


5*4* General Code Conversion Tables 


The nine general code conversion tables ana the input required to 
implement them* are shown in the following tables 
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Tab ie 5-1 

General Code Conversion Translation Table 


Table No< 

* Description 


Msb 

MPR 

(HE 

I nput 

X) Lsb 

5-7 

I ASCII 

1 

- EBCDIC 

""f ** 

1 

1 

4G 

1 

ASCII Character 

5-3 

. 1 EBCDIC 

- ASCII 

i 

1 

i 

60 

i 

I 

l 

EBCDIC Character 

5-4 

l ASCII 

1 

- SCO 

1 

1 

1 

• 

80 

t 

ASCII Character 
+ X 1 20 1 

5-5 

1 3 CD - 

i 

ASCII 

1 

SO 

I 

l 

BCD Character 

5-6 

1 ASCII 

I 

j 

- Baudot 

i 

1 

i 

E0 

1 

i 

ASCII Character 
+ X'AO* 

5-7 

1 Baudot 

1 

i 

- ASCII 

1 

1 

1 

80 

1 

1 

1 

Baudot C ha ra ct er 
+ X * 80 1 

5-8 

1 Shift 
l 

Rt Four 

i 

l 

1 

> 

AO 

1 

1 

I 

1 

Character to be 
Shi fted 

5-9 

1 Rotate 

i 

Rt One 

! 

1 

! 

i 

CO 

l 

i 

Character to be 
Rctat ed 

5-10 

1 Decimal Mult# 

! 

1 

F 0 

i 

I 

Two operands! Q- 


5*4«1« General Data Formats 


The input data formats for the general code conversion tables are 
similar# Data is input tc the RDM converter via the MPR CIO 3 and 
CIC 4 commands# Whi^e the MPR Msb is given explicitly in table 
5-1.» the Lsb input is described separately for each table# 

The translation result is transferred to the ACR via the RIO 7 
command# In the general code conversion tables* only one byte 
CLsb) is of interest (RIO 5 not required)# 
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Input Data Fermat 


: —'—t——————--——--+ 

I I 

J ROM Tabie Code I 

i l 

+- — — — --+ 


7 0 

+ ——— — - ——— 

l \ 

I Operand I 

! I 

----~--+ 


HPR Msb MPR Lsb 

CIO 4 s8 CIO 3j8 


5*4*2* ASCII to EBCDIC 


Tab le 5-2 is the ASCII tc EBCDIC Code conversion table* The MPR 
Lsb is set to the ASCII representation cf the character to be 
translated* 

Fach entry in table 5—2 is given in the formats 

1 Assigned EBCDIC Character 1 E*G*: 1 a 1 
1 Hex EBCDIC representation 1 1 7C 1 


The table starts at MPR address 4000 hex, and ends at address 
40FF hex* 


5*4*3* EBCDIC to ASCII 


Table 5-3 depicts the EBCDIC to ASCII translations* 

Each entry is given in the form? 

+ - + 

E.G* : 1 I l 

1 21 t 
+-- 

The table starts at MPR address 600G hex* and ends at address 


5*4*4* ASCII to BCD 


Table 5-4 depicts the ASCII to BCD code translations. This table 
begins at MPR address 8020 hex* Thus* it is necessary to set the 
MPR Msb to 80 and to add 20 hex to the Lsb ASCII character 
portion of the MPR before the ROM translation is initiated. 


I EECDIC Character 1 
l Hex ASCII Code J 
+ —---——-+ 
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5.4*5* 8 CO to ASCII 


Table 5-5 depicts the BCD to ASCII code translations* This table 
begins at MRR address 8000 hex. The MPR Lsb is set to the BCD 
character and the Msb portion to the start of the table (SO)* 


5*4*6* Baudot Code Conventions 


Baudot code representation has certain conventions that the 
programmer should be aware of* 

xBaudot code is a 5 bit code in the range of 00 through IF* IF is 

the highest code transmitted between stations* Therefore, a 
convention has been adopted which allows stations to distinguish 
** nt 1 re character set*^ The Ltrs convention applies tc 
alphabetic characters* The Figs convention applies tc numeric and 
special characters* 

A station transmits a IF to indicate that the following 

characters belong to the set defined by the Ltrs convention* 

A station transmits a IB to indicate that the following 

characters belong to the set defined by the Figs convention. 

Thus, a station always knows what type of characters it is 
transmitting or receiving by keeping track cf the current Figs or 
Ltrs mode* 


5*4*6<*1* ASCII tc Baudot 


Table 5-6 depicts the Baudot to ASCII cede translations* This 
table begins at MPR address E0AO* Thus it is necessary tc set the 
MPR Msb to E0 and add A0 tc the ASCII character Lsb portion. 

The Ltrs/Figs state of the result is bit 5* Thus. the program 
must send a Ltrs code (IF) if bit 5 is on. and a Figs code (IB) 
if bit 5 is off. 


5.4»6.2* Baudot tc ASCII 


Tjible 5-7 depicts the Baudot to ASCII code translations. The 
table begins at MPR address 8080* Thus it is necessary to set the 
MPR Msb to 80 and to add 80 to the Baudot character Lsb portion. 

Tc use this ta-b I e properiy. the software must determine whether 
the characters to be trasiated belong to the Figs or Ltrs set* If 



Figs characters are to be translated, no further processing is 
required* If Ltrs characters are to be translated, 20 hex must be 
added to the Baudot character before ROM Conversion is initiated* 

The output from the code converter is the ASCII representation of 
the Baudot code. 


5*4.7* Shift Right 4 - Special Field A 


Table 5-8 depicts the shift right 4/speeial field A code 
conversion taole. Output from the converter is as follows: 

7 4 3 c 

*----+-+-+-+-+ 

* I ! 1 I I 

I Field A I b7 i b 6 I b5 I b 4 | 

1 I 1 I I ! 

. ■— - + —+—— - + - + 

Field A represents the number cf bits that were one in the input 
byte. Bits b4, b5, b6 and b7 are the 4 Msb of the input byte. 

The table comprises MPR address locations AGGO through AOFF. 


5*4.8. Rotate Right One 


5-9 


Tab I e 
Each 
notation » 


depicts the rotate right one code translation table, 
entry -m the table represents the output byte in hex 

The table starts at HPR address EOOOand continues 
through address EO^F. 


5.4.9. Decimal Multiply 

Table 5-10 depicts the 9 x 9 decimal multiply code translation. 
The input byte is formed as fellows. 

7 4 3 0 

+- —— --—-+ - -—-+ 

1 I I 

1 Ai l 8i 

1 l I 

----+ 

Ai, Bis 0-9 decimal digit 

The result, via RIO 7, is given in packed decimal form* 
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Table 5-2: ASCII - EBCDIC 


ASCII 

INPUT 



0 

! 

2 

3 

4 

5 


7 

8 

9 

A 

B 

C 

D 

E 

F 

4 MSB 
(HEX) 


NUL 

00 

tft§l 

SP 

40 

H 

m 

p 

D7 

m 

p 

97 

20 

30 

41 

58 

76 

9F 

B8 

DC 


1 


1 

! 4F 

m 

A 

Cl 

m 

a 

81 

m 

m 

31 

42 

59 

77 

AO 

B9 

DD 

2 

STX 

02 

0C2 

12 

1 

2 

F2 

B 

C2 

R 

D9 

b 

82 

r 

99 

22 

iA 

43 

62 

78 

AA 

BA 

DE 


ETX 

0.3 

DCS 

13 

7B 

3 

F3 

c 

C3 

s 

E2 

*83 

s 

A2 

23 

33 

44 

63 

80 

AB 

BB 

DF 

n 

ECT 

37 

DC4 

3C 

$ 

58 

4 

F4 

D 

C4 

T 

E3 

6 

84 

t 

A3 

24 

34 

45 

64 

8A 

AC 

BC 

EA 

5 

ENQ 

2D 

NAK 

3D 

m 

5 

F5 

E 

C5 

U 

E4 

« 

85 

u 

A4 

li 

35 

46 

65 

8B 

AD 

BD 

EB 


ACX 

2E 

SYN 

32 

a 

50 

6 

F6 

F 

C6 

V 

E5 

m 

V 

A5 

06 

36 

47 

66 

8C 

AE 

BE 

EC 

m 

BEL 

2F 

ETB 

26 

i 

7D 

m 

G 

C7 

w 

E6 

9 

87 

W 

A6 

n 

08 

48 

67 

8D 

AF 

BF 

ED 

8 

BS 

16 

CAN 

18 

( 

4D 

IS 

H 

C8 

X 

E7 

h 

88 

X 

A7 

28 

SI 

49 

68 

8E 

BO 

CA 

EE 

9 

HT 

05 

EM 

19 

IS 

9 

F9 

IS 

M 

El 

y 

A8 

29 

39 

51 

69 

8F 

Bi 

CB 

EF 

A 

LF 

25 

SUB 

3F 

* 

5C 

* 7A 

m 

z 

E9 

m 

Z A9 

2A 

3A 

52 

70 

90 

B2 

CC 

FA 

B 

VT 

OB 

ESC 

27 

+ 

4E 

! 5E 

K 

D2 

KS 

t 

92 

n 

JEa 

2B 

3B 

53 

71 

9A 

B3 

CD 

FB 

C 

FF 

oc 

FS 

1C 

*6B 

<4C 

L 

D3 

EO 


|g 

2C 

04 

54 

72 

9B 

B4 

CE 

FC 

D 

CR 

OD 

GS 

ID 

’60 

~7E 

M 

D4 

i 

5A 

m 

94 

M 

09 

04 

55 

73 

9C 

B5 

CF 

FD 

E 

so 

OE 

RS 

IE 

*4B 

*6E 

N 

D5 

A 

5F 

n 

95 

SI 

OA 

3E 

56 

74 

9D 

B6 

DA 

FE 

F 

mm 

KS 

US 

IF 


p 

6F 

H 

6D 

0 

96 

DEL 

07 

IB 

El 

m3 

75 

9E 

B7 

DB 

FF 

4 LSB 
(HEX) 






ASCII 

INPUT 
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Table 5-3* FBCDIC - ASCII 


EBCDIC 

INPUT 



0 

! 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

4 MSB 
(HEX) 

0 

NUL 

00 

DLE 

10 

80 

•90 

SP 

20 

a 

26 

~2D 

BA 

C3 

CA 

Dl 

D8 

m 

y 

7D 

\ 

5C 

0 

30 


1 

SOH 

01 

DCI 

II 

81 

91 

AO 

A9 

/ 

2F 

BB 

a 6l 

m 

7E 

D9 

A 

41 

m 

9F 

i 

31 

2 

STX 

02 

DC2 

12 

82 

SYN 

16 

AI 

A A 

B2 

BC 

& 62 

K 

6B 

S 73 

DA 

8 

42 

K 

4B 

s 

53 

2 

32 

3 

ETX 

03 

DC3 

13 

83 

93 

A2 

AB 

B3 

BD 

c 

63 

i 

6C 

t 

74 

DB 

c 

43 

L 

4C 

T 

54 

3 

33 

4 

9C 

9D 

84 

94 

A3 

AC 

B4 

BE 

d 

64 

in 

6D 

u 

75 

DC 

D 

44 

M 

4D 

u 

55 

4 

34 

5 

HT 

09 

85 

LF 

OA 

95 

A4 

AD 

B5 

BF 

e 

65 

n 

6E 

76 

DD 

E 

45 

N 

4E 

V 

56 

5 

35 

6 

86 

BS 

08 

ETB 

17 

96 

A5 

AE 

B6 

CO 

f 

66 

o 

6F 

W 

77 

DE 

F 

46 

II 

w 

57 

6 

36 

7 

DEL 

7F 

87 

ESC 

18 

EOT 

04 

A6 

AF 

B7 

D 

9 

67 

p 

70 

X 

78 

DF 

G 

47 

50 

X 

58 

7 

37 

8 

97 

CAN 

18 

88 

98 

A7 

BO 

B8 

C2 

h 

68 

q 

71 

y 

79 

EO 

H 

48 

m 

Y 

59 

8 

38 

9 

8D 

EM 

19 

89 

99 

A8 

B1 

B9 

\ 

60 

1 

69 

p 

72 

z 

7A 

a 

i 

49 

R 

52 

z 

5A 

9 

39 

A 

8E 

92 

8A 

9A 

**5B 

5D 

' 7C 


C4 

CB 

D2 

E2 

E8 

EE 

F4 

FA 

B 

VT 

OB 

8F 

8B 

9B 

2E 

24 

2C 

m 

C5 

CC 

D3 

E3 

E9 

EF 

F5 

FB 

C 

FF 

oc 

FS 

1C 

8C 

DC4 

14 

< 

3C 

* 

2A 

% 

25 

<9 

40 

C6 

CD 

D4 

E4 

EA 

FO 

F6 

FC 

D 

CR 

OD 

GS 

ID 

ENQ 

05 

NAK 

15 

( 

28 

) 

29 

5F 

i 

27 

C7 

CE 

D5 

E5 

EB 

m 

F 7 

FD 

E 

so 

OE 

RS 

IE 

ACK 

06 

9E 

+ 

2B 

’38 

> 

3E 

~3D 

C8 

CF 

D6 

E6 

EC 

F2 

F8 

FE 

F 

Si 

_2L 

US 

IF 

BEL 

07 

SUB 

IA 

i 

21 

A 

5E 

? 

3F 

if 

22 

C9 

DO 

D7 

E7 

ED 

F3 

F9 

FF 

4 LSB 
(HEX) 




EBCDIC 

INPUT 
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Tab!e 5-4: ASCII - 5C0 


ASCII 

BCD 

asch 

BCD 

ASCH 

BCD 

ASCH 

BCD 

20 

1C 

30 

OA 

40 

ID 

50 

27 

21 

3D 

31 

01 

41 

31 

51 

27 

22 

20 

32 

02 

42 

32 

52 

28 

23 

00 

33 

03 

43 

33 

53 

12 

24 

30 

. 

34 

- 

04 

44 

. 34 

■ 

54 

■ ; 

13 

25 

0E 

35 

05 

45 

35 

55 

14 

26 

OF 

36 

06 

46 

36 

56 

15 

27 

10 

37 

07 

47 

37 

57 

16 

28 

IF 

38 

08 

48 

38 

58 

17 

29 

2E 

39 

09 

49 

39 

59 

18 

2A 

OB 

3A 

2A 

4A 

21 

5A 

19 

2B 

3F 

3B 

2C 

4B 

22 

5B 

OC 

2C 

3E 

3C 

- 

2B 

4C 

23 

5C 

IB 

2D 

1A 

3D 

2F 

4D 

24 

5D 

IE 

2E 

3B 

3E 

3C 

4E 

25 

5E 

2D 

2F 

11 

3F 

3A 

4F 

26 

5F 

OD 
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Table 5-5: BCD - ASCII 


BCD 

Ascn 

Displayed 

Character 

BCD 

ASCH 

Displayed 

Character 

BCD 

asch 

Displayed 

Character 

00 

23 

# 

16 

57 

W 

2B 

3C 

< 

01 

31 

1 

17 

58 

X 

2C 

3B 

i 

02 

32 

2 

18 

59 

y 

2D 

5E 

—i 

03 

33 

3 

19 

5A 

z 

2E 

29 

) 

04 

34 

4 

1A 

2D 

- 

2F 

3D 

= 

05 

35 

.5 

IB 

5C 

I 

30 

24 

$ 

06 

36 

6 

1C 

20 

(space) 

31 

41 

A 

07 

37 

7 

ID 

40 

@ 

32 . 

42 

B 

08 

38 

8 

IE 

5D 


33 

43 

C 

09 

39 

9 

IF 

28 

( 

34 

44 

D 

0A 

30 

0 

20 

22 

=§ 

35 

45 

E 

OB 

2A 


21 

4A 

J 

36 

46 

F 

OC 

5B 


22 

4B 

K 

37 

47 

. 

G 

OD 

5F 

— 

23 

4C 

Li 

38 

48 

H 

OE 

25 

% 

24 

4D 

M 

39 

49 

I 

OF 

26 

• & 

25 

4E 

N 

3A 

3F 

? 

10 

27 

i 

26 

4F 

O 

3B 

2E 

• 

11 

2F 

/ 

27 

50 

F 

3C 

3E 

> 

12 

53 

S 

28 

51 

Q 

3D 

21 

z 

13 

54 

T 

29 

52 

R 

3E 

2C 

9 

14 

55 

u 

' 

2A 

3A 

• 

• 

3F 

2B 

+ 

15 

56 

, 

V 


- 
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Table 5- 6« ASCII - Baudot * 
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Baudot 

Ascn 

Display 

Baudot 

asch 

Display 

Baudot 

asch 

Display 

00 

00 

Null 

16 

'Jr. f, m 

30 

0 

2B 

4A 

J 

01 

33 

' 3 

17 

31 

1 

2C 

4E 

N 


05 27 
06 38 


0C 0C(2C) 

0 D FF 

OE 3A 

** OF 08(28) 

10 35 j 

11 2B 

12 29 

13 32 

14 23 

15 36 

* The ASCII output 
##The ASCII output 


Space 

i 

8 

7 

CR 

$ 

4 

Bell 

Error(,) 
Not Used 

• 

Error( () 

5 


18 
19 
1A 
IB 
1C 

ID I 2F 


2A 52 


is 0C and should be 2C, 
is 08 and should be 28. 


FF Not Used 
2E 


Not Used 
Null 
E 

LF 

A 

Space 

S 

I 

u 

CR 

D 

R 


FF Not Used 


RF Not Used 













Table 5-8: shift Right Four 


INPUT 

BYTE 



0 

u 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 


ESSEm 

IfSiaElM 

0 

00 

m 

12 

23 

m 

25 

26 

37 

18 

29 

2A 

3B 

2C 

3D 

3E 

4F 

BPiSiiSS 

1 

10 

21 

22 

33 

24 

35 

36 

47 

28 

39 

3A 

4B 

3C 

4D 

4E 

5 F 


2 

10 

21 

22 

33 

24 

35 

36 

47 

28 

39 

3A 


3C 

4D 


5F 


3 

20 

31 

32 

43 

34 

45 

46 

57 

38 

49 

4A 

5B 

4C 

5D 

5E 

6F 


• 

4 

10 

21 

22 

33 

24 

35 

36 

47 

28 

39 

3A 

4B 

3C 

4D 

4E 

5F 


5 

20 

31 

32 

43 

34 

45 

46 

57 

38 

49 

4A 

5B 

4C 

5D 

5E 

6F 


6 

20 

31 

32 

43 

34 

45 

46 

57 

38 

49 

4A 

5B 


5D 

5E 

6F 


Mm 

30 

41 

42 

53 

44 

55 

56 

67 

48 

59 

5A 

6B 

5C 

6D 

6E 

— 

7F 


8 

1 0 

m 

22 

33 

24 

35 

36 

47 

28 

39 

3A 

48 

3C 

4a 

4E 

5F 


9 

20 

31 

32 

43 

34 

45 

46 

57 

38 

49 

4A 

5B 

4C 

5D 

5E 

6F 


A 

20 

31 

32 

43 

34 

45 

46 

57 

38 

49 

4A 

5B 

4C 

5D 

5E 

6F 


B 

30 

41 

42 

53 

44 

55 

56 

67 

48 

59 

5A 

6B 

5C 

6D 

6E 

7F 

• 

C 

20 

m 

32 

43 

34 

45 

46 

57 

38 

49 

4A 

5B 

40 

5D 

5E 

6F 


D 

30 

41 

42 

53 

44 

55 

56 

67 

48 

59 

5A 

6B 

5C 

6D 

6E 

7F 


E 

30 

41 

42 

53 

44 

55 

56 

67 

48 

59 

5A 

6B 

50 

6D 

6E 

7F 


F 

40 

51 

52 

63 

54 

65 

66 

77 

58 

69 

6A 

7B 

6C 

7D 

7E 

8F 


bbb 

32 10 


















INPUT 

BYTE 
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Table 5-9s Rotate Right One 


INPUT 

BYTE 


r—" 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 

4 MSB 
(HEX) 


00 

08 

10 

18 

20 

28 

30 

38 

40 

48 

50 

58 

60 

68 

70 

78 


■91 

80 

88 

90 

98 

AO 

A8 

BO 

B8 

CO 

C8 

DO 

D8 

EO 

E8 

FO 

F8 

2 

01 

09 

m 

■ 

■ 

29 

30 

39 

40 

49 

50 

59 

60 

69 

70 

79 

3 

81 

89 

91 

99 

Al 

A 9 

Bl 

89 

m 

C9 

Dl 

D9 

El 

E9 

FI 

F9 

4 

02 

OA 

B3 

1A 

22 

2A 

32 

3A 

42 

4A 

52 

5A 

62 

6A 

72 

7A 

5 

82 

8A 

92 

9A 

A2 

AA 

B2 

BA 

C2 

CA 

D2 

DA 

E2 

EA 

F2 

FA 


03 

OB 

13 

1 B 

23 

2B 

33 

3B 

43 

4B 

53 

5B 

63 

6B 

73 

7B 

IB 

83 

8B 

93 

9B 

EsI 

A8 

83 

BB 

C3 

CB 

D3 

DB 

E3 

EB 

F3 

FB 

n 

04 

OC 

13 

na 

24 

2C 

34 

3C 

44 

4C 

54 

5C 

64 

6C 

74 

7C 

9 

84 

SC 

94 

9C 

A4 

AC 

B4 

BC 

C4 

CC 

D4 


E4 

EC 

F4 

FC 

A 

05 

OD 


ID 

25 

20 

35 

3D 

45 

4D 

55 

5D 

65 

6D 

75 

7D 

B 

85 

80 

95 

9D 

A5 

AD 

B5 

BD 

C5 

CD 

D5 

DD 

E5 

ED 

F5 

FD 

C 

06 

OE 

m 

IE 

26 

2E 

36 

3E 

46 

4E 

56 

5E 

66 

6E 

76 

7E 

D 

86 

8E 

96 

9E 

A6 

AE 

B6 

BE 

C6 

CE 

D6 

DE 

E6 

EE 

F6 

FE 

E 

07 

OF 

17 

m 

27 

2F 

37 

3F 

47 

4F 

57 

5F 

67 

6F 

77 

7F 

P 

87 

8F 

97 

9F 

A7 

AF 

B7 

BF 

C7 

CF 

D7 

DF 

E7 

EF 

F7 

FF 

bb bb 

3 2 10 




t w - * 

INPUT 

BYTE 
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Table 5-10: Decimal Mu triply 


INPUT 

BYTE 

r. 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

c 

D 

E 

F 

4 MSB 
(HEX) 


00 

00 

00 

00 

00 

00 

00 

00 

00 

00 




■ 

■ 

| 


B 

00 

01 

02 

03 

04 

05 

06 

07 

08 

09 




■ 




2 

00 

02 

04 

06 

08 

10 

12 

14 

na 

18 






1 


3 

00 

03 

06 

09 

12 

15 

18 

m 

24 

27 








4 

00 

04 

08 


16 

20 

24 

28 

32 

36 








5 

00 

05 

10 

15 

20 

25 

30 

35 

40 

45 








6 

00 

06 

m 

18 

24 

30 

36 

42 

48 

54 







■ 

7 

00 

07 

m 

m 

28 

35 

42 

49 

56 

63 



1 



■ 


8 

00 

08 

□ 

24 

32 

40 

48 

56 

64 

72 


■ 

■ 





9 

00 

09 

18 

27 

36 

45 

54 

63 

72 

81 








A 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 








B 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


m 

1 

■ 




C 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


■ 

■ 





D 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 




■ 




E 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 


■ 

■ 

■ 




F 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 



■ 

m 




b 3 b 2 b ( b O 






FIELD B 
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6* Keyboard Subsystem 


The keyboard subsystem comprises a Cua 1 Extended Drive ROM option 
Keyboard Control ler which can service one or two keyboards with 
no loss of efficiency or functionality of either* 

The keyboard controller is located within the housing of the TPUj 
and each keyboard is connected to the controller by a cable 
consisting of four twisted pairs* A keyboard may be up to 200G 
feet from the controller* the controller when used as a single 
keyboard controller* is program compatible with any standard 
ID/20 keyboard controller (Model 001-02-02; and with the Dual 
Fxtended Drive Keyboard Controller (Model 010-46-02 ; when the 
latter is used as a single keyboard controller* 


6*1* Addresses and Interrupts 


Each keyboard has its own unique address which normal ly coincides 
with the screen address of the nearest screen; however s the 
relationship between a keyboard and a display subsystem is 
totally under program control* 

The controller uses two addresses and one interrupt level« One 
address and the interrupt level are used for keyboard control. 
The other address is used to read the terminal address option 
block and to reset the watchdog timer* 

The controller is always installed in 1/0 controller slot C2 of 
the SPD 10/25 chassis and when so installed:, the following 
relationships are fixed: 

* 1/0 pert J1 (Master Terminal Keyboard) carries 
keyboard address 0* 

* J/Q port J2 (Auxiliary Terminal Keyboard; carries 
keyboard address 0* 


6*1*1* Boot Switches 


The Boot switch located near J15 initiates a ROM boot when wired 
to slot C2 * 

Switch SW1 on the keyboard controller initiates a keyboard boot* 
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Executive Keyboard 




















6.2* Keyboards 


Two models of keyboards are available for the SPD 10/25* They are 
the Standard Keyboard and the Executive Keyboard* shown in 
figures 6-1 and 6-2. 

From the standpoint of software* the Executive Keyboard is 
identical to the Standard keyboard with the following exceptions: 

* If a program uses the Executive Keyboard lights* 
they must be refreshed at least every 500ms* If 
they are not* the lights will be extinguished* 
This prevents the processor from displaying false 
information if the power is lost or the program 
crashes. It is a good idea to include a refresh 
routine in every program that uses the keyboard 
lights* sc that ccmpatibi1ity problems are 
minimized. 

* As noted in figures 6-1 and 6-2* the left and 
right key banks are positioned differently on the 
two keyboards* 

* The repeat rate of the Executive Keyboard is 
higher than that of the Stanadard Keyboard. This 
causes a DOS interface problem* 


6.3* Keycode Generation 


The keyboard transmits keycode data* generated by the a key(s) 
depression* to the keyboard controller. Upon receipt of the 
information* and depending upon the software design* the 
controller may interrupt the processor. 

For each keyboard option* the codes generated by the subsystem 
are unique. The following routine can be used to check the 
generated code of each key: 

Wait for keyboard input 
Read key 

Display code in keyboard lights 
Contin ue 


6*4* Keyboard Instruction Set 


Table 6-1 summarizes the keyboard controller commands. Each is 
described in further detail in separate sections* 


LOOP JFACK 4 * 2* S. 
RIO 0*2 
CIO 2*2 
JMP LOOP 
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+ - 

1 

1 Function 

1 Cede 

+ -- 

+ — .- —-- 

2 CIO 

+ - 

* 

9 

• RIO 

• 

• 

WIO 

• 

: TIO 

1 

! 0*2 

I 

+••■•••••»•«• 

! 

* 

• 

• 

s Read 

s Character 

• 

• 

• 

e 

Device 

Present ? 

1 1 j2 

+•••••••••*•• 

Enab1e 

R epeats 

p ^ 

• 

• 

• 

• 

• 

• 

— 

! 2*2 
l 

Set 

L ighfs 

► 

Read 

Status 

► 


1 

I 4*2 

1 

Mask 

Inter rupt s 


Sound 

Alarm 

Input 

Rea dy ? 

i 5*2 

I 

,» , , , 

Cent ro 1 1er 

R nset 

— 

— 

— 

1 

1 6*2 

I 

| 




Keyboa rb 

0 Ready? 

! 8*2 

1 

Unrr-ask 

Inter rupts 

S|919tm ••• 



Cent ro11er 
Busy ? 

1 

1 9*2 

S ele ct 
Keyboa rd 

-- 
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6.4*1* CIO Is Enable Repeats 


This^ command enables the interrupting keyboard to generate 
mu!tip Ie int er rupt s if the key is continually depressed. After 
the initial interrupt* a second interrupt is generated 
approximately 1/4 to 1/2 second later* All subs equent interrupt s 
are generated at approximately 1/10 second intervals. 

This instruction must be used after all interrupts if the RIO 2* 
Reed Status* command is to be used effectively as the auto—exec 
inst ru ction. 


6.4.2* CIO 2s Set Lights 


This command sends the contents of the ACR to the eight Light 
Emitting Diodes (LEDs) on the keyboard selected by the CIO 9* 
Select Keyboard* command* or keyboard C if the CIO 2 instruction 
is issued immediately after an IOR or power up* 

The data is sent in the following formats 

Bits 

7 6543210 ACR Eits 

7 6 5 4 3 2 1 0 LEDpositicn 

Thus* the rightmost Keyboard LED corresponds to the ACR Lsb* 

This inst ru ction will be ign cr ed by the ha r dwa r p if the 
controller is busy CTIO S AC Know I edg ed ). 

Transfer of data to the LEDs takes approximately 0.30ms* 


6*4*3* CIO 4? Mask Interrupts 


This command prevents any keyboard from interrupting the 
processor* Interrupts are also masked by the issuance of an IOR 
cr a CIO 5* Reset* command or by a power-up* 


6*4*4* CIO 5s Controller Reset 


This command clears all controller logic* masks interrupts and 
selects keyboard 0 for light or alarm transmission. Polling of 
the keyboards commences with keyboard 0* 
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6* 4 » 5 • 


CIO 8s Unmask Interrupts 


This command allows the keyboards to interrupt the processor* 


6»4»6* CIO 9: Select Keyboard Output 


This command selects the keyboard which is to receive light or 
alarm data. The ACR is used as follows: 

(ACR ) Action 

0 Select Keyboard 0 

1 Select Keyboard 1 

Note: 1* Pcwer-upj I0R or CIO 5 commands select keyboard 0. 

2m The CIO 9 command will be.ignored if the controller is 
busy (TIC 8 ACKs)* 


6*4*7* RIO 0: Read Character 


This command reads the keyboard data into the ACR* If a parity 
error occurred in the transfer of data from the keyboard to the 
control ler j then all zeroes will be transferred to the ACR* 

N ct e: 

1* This command will not be acknowI edged if data is not 
available for transfer to the ACR (a key has not been 
depressed). 

2* Polling of the keyboards will resume upon execution 
of this instruction* 


6*4*8* RIO 2: Read Status 


This command reads the keyboard address and repeat status into 
the ACR as follows: 


7 6 

+-- ---- 

0 I Repeat l 

—--- S et t c ail 0 

1 1 Non Repeat ! 

+ --- + - 


1 0 

-+ -- 

1 Kybd G l 

-- + 

I Kybd 1 I 
--+ 
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Not e: 

1* If the 2 co.Tim and is used* it must be issued prior 
to the RIO 0* Read Character* command* 

2. This command is acknowledged only when the controller 
has received data from a keyboard* 

3* The repeat status bit is only useful if CIO 1, Enable 
Repeatj was issued after the prior interrupt for that 
keyboard* 


6*4*9* WIO 4: Sound Alarm 


This command generates an audible alarm at the keyboard* 

Note: 

U The keyboard is selected via the CIO 7 command* or 
keyboard 0 is selected after an IOR* CIO 5 or 
power-up* 

2* This instruction will be ignored by the hardware if 
the controller is busy (TIO S ACKs)* 

3* This command is always acknowledged* 


6*4*10* TIC 0: Device Present 


This command wil I be acknowleged if the controller is present* 
This command does NOT indicate the presence of a keyboard. 


6*4*11* TIO 2' Controller Ready 


This command will be acknowledged if the controller has received 
data from the keyboard* 

6*4*12* TIO 6: Keyboard 0 Ready 


This command will be acknowledged if data has just been read from 
keyboard 0. This instruction is valid only after the RIO 0* Read 
Character* command has been issued* 

This command can be used tc check 10/20 compatibi 1 ity• 
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6.4*13* TIO 8: Lights/Alarm Susy 

This command will be acknowledged if the controller is in the 
process of sending light or alarm data to a keyboard, 

6*5* Terminal Address Designation 


The controller contains an option block which allows the user to 
specify a uniquej 15 bit terminal address for each terminal* This 
addresses read by issuing an RIO C then RIO 1 command addressed 
to device NINF (9)* The address is specified oy option block 
wiring on the controller* 

Not e • 

These two RIC commands may be used to read the hard wired 
values of the low and high order bytes specific tc a given 
terminal* This allows the same program in several 
different SPQ 10/25 terminals* whose two parameter values 
are different for each terminal, to identify its terminal 
a dd re ss . 


6*5»1* RIO 0*9: Read Terminal Address 


This command leads the low order eight bits at the address into 
the ACR * 

Note : 

1* This command is used in conjunction with the RIO 1, 
Read Interchange Address* command* 

2* This command is always acknowledged* 

lew-order 8-bits will be all zeroes if no option 
block is present* 


6*5*2* RIO 1*9: Read Interchange Address 


RIO 1 loads the high order seven bits at the address into the 


Net e: 

1* This command is used in conjunction with the RIO 0* 
Read Terminal Address* command* 

2* The high order bit of the data transferred to the ACR 
is always 0* 
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3# This command is always acknowledged. 

4* The high-order 7 bits will be all zeroes if no option 
block is present• 


6.6. ROM Bootstrap Loader 


The Dual Extended Orive/ROM option keyboard controller contains a 
PROM bootstrap loader* The loader provides an easy method of 
self-loading an _ operational program through standard 
communications* disk* tape.* etc*. PROM data is encoded in 
standard eight-bit core format.* net in boot format* Each PROM 
contains 256 bytes a n d the SPD 10/25 can accomodate up to two 
PROMs (512 bytes) total* 

A PROM bootstrap may be initiated either automatically or by the 
watchdog timer* or by manual |y depressing the BOOT Button located 
near J15* 

Bootstrap is terminated by either* 

* The detection of FF in an even location of the PRCMj 
c r 


* After 512 bytes have been loaded into memory from the 
PROM. 


6*6*1. Watchdog Timer 


The watchdog tirn^r may be used to automa t i ca 1 I y initiate 
bootstraps. It is enabI ed/di sab Ied by a toggle switch ($W2) 0 n 
the cont roller. 

One instruction is provided: 

TIO 0j 9: Reset Watchdog Timer 

The Wathcdog timer starts a PROM load if it is not reset in three 
seconds* It may be reset by: 

* PROM Lead 

* Power-On 

* Issuance of a TIO G* Reset Watchdog Timer.* command* 
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Real Time Clock Programming 


The RTC_mchcates the passage of actual tine and has the highest 
evel interrupt priority. The RTC interrupts 60 times a second 
(every 16.7ms). For programming purposes* the RTC is utilized in 
the same manner as an external device* and is addressed as device 
15 * 

Three commands are available: RIO 0* Read, CIO 1, Unmask, and CIO 
2 3 Mas ko 


The read command is acknowledged only when 
unmasked and has interrupted* If the 
acknow ledged* the interrupt and ACK signal are 
transferred to. the ACR is all zeroes* 


the RTC has been 
Read command is 
cI eared* The data 


If the Read command is not acknowledged* the auto-exec interrupt 
structure returns program control to the background processing. A 
summary of RTC commands is given in the following table. 


RTC Command Summary 


Fun ctirn 

Code 

Command 

RIO G* 15 

R ead 

CIO 1*15 

Unmask 

CIO 2*15 

M ask 
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8•> Cyclic Redunancy Check 


A cyclic redundancy check (CRC) is a method of error detection to 
determine if a transmitted message has been received correctly* 

While it is possible to do the required CRC calculations by 

programming* their complexity would require a large amount of 
memory a n d execution time* thus a hardware circuit is provided. 

A cyclic redundancy check is performed as follows* 

* The transmitting terminal (with a cyclic check 

controller) develops a cyclic check character (CCC) 

by accumulating a logic polynomial equation 

remainder as each character is transmitted* 

* At the same time* the receiving terminals 

controller performs the same operation on each 

received character until the final character cf the 
message is received* 

* The transmitting terminal sends the final remainder 
of the polynomial division immediately following 
the last character cf the message* 

* The receiving terminal compares the CCC developed 
at the transmitting terminal with the CCC developed 
et the receving terminal* 

* If the two cyclic check characters are identical* 
the message is assumed to be correct* 


A CRC operation oenters around two registers* a 16 bit 
accumualtor (AC) register and a 8 bit shift register (SR)* The 
cyclic check character being calculated is stored into the AC and 
various ^ commands are available to extract and restore 
intermediate results* This feature allows a single cyclic check 
character generator to be used with a number of communications 
I/O controllers* all cf which use the same cyclic check 
polynomial* 


8*1* CRC Character Generator 


The SP3 1C/25 Cyclic Redundancy Check Character Generator (CCC 
portion of the Screen Buffer/CCC/ROM CentroIler performs the 
algorithm required to do cyclic check calculations* 

Controller address eight is used to acess this function* The CCC 
logic neither checks nor computes individual character parity* 



When operating under conditions of Cursor Disabled (see section 
4»3« 2. )* the WIO 6 and WIO 7 commands must not be issued during 
refresh (TIO 2 ACKed) 

The CCC generator is capable of calculating either of two 
software selectable polynomials# 


8•1•1• PARS Cyclic Check 


This mode of the CCC generator works with six-bit data characters 
and a po ly no mi a l : 

6 5 

X + X + 1 

The CCC generator consists of a 6-bit Receiving register. The CCC 
is six bits lono. 


3*1*2* Bisync Cyclic Check 


This mode of the CCC generator works with eight-bit data 
characters and a polynomial: 

16 15 2 

X + X + X +1 

The CCC generator consists of a 16-bit CCC Accumulator and an 
6-bit Receiving register. The CCC is 16 bits long (two 8-bit 
cha racters)♦ 


8*2. CRC Instruction Set 


The CRC^command set is summarized in table 7-1 and described in 
detail in the remaining sections. 


8-2 



Table 7-1 CRC Instruction Set 


Function 

Code 

: CIO 

RIO 

: WIO 

a 

m ■ 

TIO 

0*8 

Mode 

Se1ect 

— —mm 

•mm mm 


2*8 

************ 



Ref resh 

3 u s y ? 

6*3 

Clear 

CCC Gener 
Accumulater 

Ext r a ct 

CCC Gener 
Accumulator 

C y c 1 i c 
Check 

Accumu1 ate 


7*8 

. ^ _ 

• 

« 

— 

Load CCC 
Generator 
Accumuiator 

— 


3*2* 1» CIO 0• Mode Select 


This command determines whether the CCC generator wifi execute 
PARS or Bisync Cyclic check computations* 

Not e: 

When use is made of the CIO 0 instruction to select 
the particular Cyclic Check algorithm* care must be 
exercised to ensure that other refresh subsystem 
attributes defined by the CIO 0 instruction are not 
inadvertently modified* See section 4*6*1* for further 
i nf ormat ion* 


8*2*2* CIO 6s Clear CCC Generator Accumulator 


This command unconditionally clears the CCC generator 
accumu I atc r® 

This command is issued prior to loading the CCC generator 
accumulator* 












RIO 6s Extract CCC Generator Accumulator 


The contents of the CCC generator accumulator are transferred to 
the ACR • This command is always acknowledged* 

In PARS applicaticnsj only one RIO 6 command is necessary to read 
the CCC generator accumulator* In Bisync spp l icat ions* however j 
two RIO 6 commands are necessary* 

generator accumulator* 

In Bisync app1Ications » two successive WIO 7 commands are ney to 
issue a WIO 7 with the ACR set tc zero* This action shifts the 8 
Lsb's to the location occupied by the 8 hisb*s in the CCC 
generator accumulator* A second RIO 6 is then issued to extract 
the contents of the CCC generator accumulator 8 Lsb*s (which are 
now contained in the 8 Msb location)* 


8*2*4* W10 6: Cyclic Check Accumulate 


This command causes the contents of the ACR to be transferred to 
the CCC generator receiving register. The data is processed and 
included in the updated Cyclic Check in the CCC generator 
accumulator* 

This^ command is always acknow 1 edged, A one cycle delay is 
required between successive WIO 6 and/or WIO 7 commands* 


V.I0 7: Load CCC Generator Accumulator 


This ccmmmand causes the contents of the ACR to be transferred to 
the CCC generator accumulator* 

In PARS applications* only one WIO 7 utilities for use by disk 

This section famapp l ications* two successive WIO 7 commands are 
necessary* The first WIO 7 command leads the CCC generator 
accumulator with eight Msb*s and the second WIO 7 command loads 
the CCC generator accumulator eight Lsb»s* 

In both applicat ions* the WIO 7 command must be preceded by a CIO 
6j Clear CCC Generator Accumulator j command* 


The WIO 7 command is always acknowledged* A one cycle delay is 
required between successive WIO 7 and/cr WIO 6 commands. 


* 
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9* SPD/DOS Diskette Operating System 


SPD/DOS is a diskette resident operating system for use with the 
SPD Family of computer terminals equipped with a floppy diskette 
unit* It provides facilities for program development 
rr.a i nt e na n c e * and storage and implements a file system plus 
attendant utilities for use by diskette applications programs* 

This section familiarizes the programmer with the general 
operation of the DOS utilities*. For information concerning the 
inclusion of relevent DOSLIB routines into the applications 
program* refer to the manual entitled ! SPD/D0S Programmers 
Reference Manual 1 * 


9*1* SPD Family Required Hardware 


The following hardware is required for operation of SPD/DOS on an 
SPD Family machine: 

* Single or dual diskette attached to channel 7* 

* 64. cr 8G character per line display on the refresh 
channel* screen 0* and 

* An upper-case or upper/lower-case keyboard attached 
to the keyboard channel* keyboard Q* 


9*1*1* Optional Hardware 


The following peripheral devices may be used by DOS: 

* Line printer models LP125* LP20C* LP250* LP3G0* or LP40G 
attached to any channel using the parallel controller* 

* Character printer models P-13G* P-12CC* P-1 65/1 65A* or 
P-1 658 attached to any channel using the parallel 
cont ro1ler» 

x Character printer models P-1CG-2* P-120C-2* P-165/ 

P-165A-2 nr P-1 658—2 character printer attached to any 
unit of a SPD 20 Family multiple printer controller on 
channel 13* 

* P -158 printer attached to an asychroncus controller on 
any channel or to any unit of an SPD 2Q Family mulitple 
printer controller* 

* Termiprinter attached to an asychroncus controller on 
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a ny channel • 

* Card reader/punch on any channel* 

* Paper tape reader on any channel. 

* Magnetic tape transport attached to any channel* 

* Cassette tape transport attached tc any channel* 

* Bullt-in* on SPD 20/20 and 20/30 models only* 
cassette leader on channel 11. 


9.2. Diskette Construction 


The floppy disk is housed in a protective pI atic case which 

cleans the disk while it is revolving in the drive unit* No 

attempt should ever be made to touch the exposed surface of the 
disk* or to clean it. Only a soft felt tip pen should be used to 
write on the disk’s plastic case. The disk should be kept in its 
protective envelope when net it is not in the drive. 

The disk is divided into 64 tracks numbered consecutive!y* from 

the outer, edge to the center* from 0 to 63. Each track is 
composed of 32 sectors numbered consecutively from 0 to 31. 
Diskette I/O is done on a sector by sector basis at the hardware 
i eve l o 

SPD/DOS uses the first three tracks of the disk leaving tracks 3 
to 63 free for program use. Track 0 contains the bootstrap loader 
and nucleus code* Track 1 contains the diskette file directory 
and track 2 is reserved for the core image which is automatically 
saved when an abnormal or manual boot occurs. 


9*2*1. Diskette I/O 


For a thorough treatment of the subject at the hardware level* 
refer _to the^ SPD o'-250 Diskette Reference Manual* For a 
discussion of diskette I/O DOSLIB routines* refer to the SPD/DOS 
Programmers Manual* 

Diskette I/O involves two series of commands* those that affect 
the transfer of data between the diskette buffer and the TPU 
(WIOj RIO series)* and those that involve the transfer of data 
between the buffer and the diskette (CIO series). 

The diskette buffer is a 256 byte MOS RAM memory which resides on 
the diskette controller beard. 128 bytes of the buffer is used tc 
store the data tc be transmitted to the diskette* The remaining 
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128 bytes can be used by the software program for its own 
purposes* In particular* DOS uses these bytes to store control 
information for access by its utilities* 


9*2*2* Diskette I'rite Protection 


Any diskette can be protected from accidental write operations by 
engaging the Write-Lock button on the drive to be protected* In 
this .mode* all write operations to that diskette will be 
inhibited* DCS utilites return appropriate error codes if an 
attempt is made to write on a disk that has its Write-Lock 
engaged. 


9*3* Operation of Nucleus 


Track 0 of every SPO/DOS diskette contains a boostrap loadable 
program cal led the nucleus* When a bootstrap occurs* a short 
loader program is booted into cere which then loads the nucleus* 
The nucleus provides a set of basic commands for the maintenance 
of a file system* The remainder of the diskette is used for a 
file directory and data file area* The files are cf four types 2 

Source Files (S) A source file is a sequential file 
containing characters from the standard graphic set and is 
normally used for Assembly language source programs* 

Object Files (0) These are executable programs typically 
produced as output from the SPD/DOS Assembler* 

Relocatable Files (R ) These are libraries of relocatable 
modules produced by the SPD/DOS Relocatable Assembler* A 
given file can contain one or more modules* Relocatable 
modules are included in absolute assemblies by use of the IN 
(IN Rfi1e*meduIe) Assembler pseudo-op* 

Data Files <D) A data file is a contiguous set of tracks* DCS 
imooses no particular structure on a data file* The strucure 
of the data file is determined by the program which makes use 
o the file* Within DOS itself* data files are used as direct 
access work files* 


9*3*1* Nucleus Load Procedure 


The nucleus is loaded from the diskette by following the diskette 
standard boot procedure: 

Load any SPD/DOS diskette into unit 0 of a single or dual 
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diskette and depress the boct button. The nucleus will be loaded 
automaticaI Iy» 

^ ^ ^ diskette fails to boot,* the follow ins procedure is 

recommended. Remove the diskette and carefully revolve the center 
hub o. the ^diskette.* making certain that no hand contact is made 
with l he diskette surface. Replace diskette in unit and depress 
b°ot button. If the diskette still fails to boot* its bootstrap 
record may have been destroyed. In this case.* it is necessary to 

re-fcrmat the bcostrap code to rescue the disk (see section 

9.S.2*1»j FORMAT Utility). 

In addition.* virgin disks cannot be booted. All disks must be 
FORM aT ted. FORMAT writes sector ident i f i ca ti on and nucleus code 
onto the diskette. 

Indication that the nucleus has been booted in is given by the 

appearance of the nucleus display on screen 0. The nucleus 

displays the file directory as* illustrated. From this it is seen 
t a T the file directory is displayed on the screen using one line 
of display for each active file. 


9.3.2. Directory Display Format 


Every SPQ/DOS diskette is assigned a Disk Serial Number (DSN) of 
up to eight alphanumeric characters in length. Follewina a beet 
manual boot procedure* the directory of unit 0 is always 
displayed. The unit whose directory is currently being displayed 
is referred^ to as the Currently Selected Unit. The current ly 
selected unit concept is fundamental to DOS file identification. 

The meaning of tne various fields cf the directory is as follows: 

S ^ile status: 

Blank for an active file* * for an erased file* 
and ? for a questionable file. The ? status 
occurs as the result of certain operations in 
which errors were detected. A file with a ? 
status may be used as though it was an active 
fi|ej although it is highly probable that the 
information contained in that file was not 
recorded properly. 

T Type: 

G for Object s S for Source* R for Relocatable and 
0 fer Dcta file* 
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Name: 

This field contains the file-name which is 
composed of up to eight a Iphanumeric characters* 
the first of which must be alphabetic, 

FT First Track* 

In decimal* the number of the initial track j 
ranging from 0 to 63. 

IF Interlace Factor* 

Th^^ interlace factor is the separation between 
locically sequential sectors* It is possible to 
read up to 6 sectcrs on one revolution of the 
disk* Hcweverj the real time that is used for 
processing one sector read may be longer than the 
time required to read the next logical sector* 
Therefore* in the worst case* the disk may have 
to rake another complete revolution in order to 
process the next logical sector* 

Thusj the interlace factor is used to specify the 
order in which sectors are read and/or written* 
For example it is set to 1 to read sectors in the 
sequence 0 *1 *2* 3 * * * 3 1, If the interlace factor is 
set to 5* it will cause the sectors to be read or 
written in the sequence Q*5*1G*..30 during the 
first revolution of the disk and in the sequence 
3*8 j 13*»*28 during the second revolution of the 
disk* Sectcrs can be read or written in this 
sequence until all 31 have been processed* 

Within SPD/DOSj ail 0 files have an interlace 
factor of 5* R files have a factor of 9. Source 
file created by the standard source file utility 
rcutnnes have an interlace factor of 11* For 
purely random access of files* the interlace 
factor is set to 0* In general* the interlace 
factor may be any odd value from 1 to 31* 

NT Number of Tracks* 

This "field shews* in decimal* the number cf 
consecutive tracks assigned to the file* It is a 
value between 1 and 61. 

labfl* 

The label, on a file is up to 40 characters of 
information from the graphic character set* The 
label is used for identification purposes only* 
and the choice of the label is entirely up to the 
user. 


If the file directory is greater than that which will fit on a 
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sinaje screen*.the space bar may be pressed to page through the 
remainder of the directory* 


9*3*?* Keyboard Indicator Lights 


Following a manual beet of the nucleus* the rightmost indicator 
lamp is lit* The next to rightmost indicator lamp is lit if a 
program returns to the nucleus in an abnormal manner* Alt 
indicators are off following a normal return to the nucleus* 
Indication that the core image has been saved (barring a write 
protected unit 0) in given if either indicator is lit* 

Entering any command causes all indicator lamps to be turned off* 


S P D / DOS SPO DISKETTE OPERATING SYSTEM VERSION 7.02 

UNIT 0 OS N=S YS T EM 

ST ..NAME*. FT IF NT•*•*•••**.*,*«*,LABFL***»******»»****»*, 

0 ASSFMSL C 03 ns 06 SPD/DOS ASSEMBLE V7*19 76-08-17-1500 

0 CNFG C 9 05 01 SPD/DOS CNFG V7.01 76-Q7-07-210Q 

0 COPY 10 05 04 SPD/DOS COPY V7*06 76-08-01-2100 

0 CREATE 14 G5 01 SPD/DOS CREATE V7.G1 76-08-01-2000 

0 DC0PY 15 DP SPD/DQS DC0PY V7*06 76-08-01-^100 

0 EDIT 1605 02 SPD/DOS EDIT V7.02 76-06-07-1700 

0 ERASE 1 8 05 01 SPD/DOS ERASE V7.Q1 76-0 8-01-211 5 

0 FORMAT 1905 02 SPD/DOS FORMAT V7.02 76-07-07-1430 

0 LIST 21 05 01 SPD/DOS LIST V7*01 76-08-01-1545 

0 PACK 2 2 05 01 SPD/DOS PACK V7.01 76-08-G6-1 300 

0 RASSEM8L 23 C5 06 SPD/DOS R ASS EM 3 L V7*06 

0 RENAME 29 OS 01 SPD/DOS RrNAMP V7.01 76-08-01-1 600 

0 TMCVE 3 0 05 01 SPD/DQS TMCVE V7.01 76-0 8-01-1 53 0 

0 UPDATE 31 05 02 SPD/DOS UPDATE V7.01 76-07-31-08C0 

0 VERIFY 3 3 05 0 1 SPD/DOS VERIFY V7.01 76-08-01-1 630 

0 XOISK 34 05 01 SPD/DOS XDISKY V7*01 76-07-19-1400 

0 ZAP 3 5 05 02 SPD/DOS ZAP V7.C-3 76-08-05-10C0 


9*3*4* File-Name Format 


.Two fi i p s on the same diskette of the same type (0*R.,S*D> may net 
have the same file name* However* it is permissable to have two 
files of the same type and file-name on two different units* 
Thus* a standard dqs format has been adopted to differentiate 
between files: 

U.FIL^NAM^ 
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Whenever a file narre is required* it can 
format# U is the number of the diskette 
resides (G or 1 ) and FILENAME is the 8 
desired fi le. 


ce specified in this 
unit on which the file 
character name cf the 


Note: u. may be emitted if the file resides on the Currently 

t* shown ^ the current directory display. 

•i, E NAME 1S the nSn;e &f a file to be created, then it 
will be created on the unit specified by u, 0 r* if 

omitted* cn the currently selected unit* 


The 
DOS and 


f i I e-names AUTO., list and 


should be considered to be reserved# 


WORK have special significance to 


9«4* Nucleus Commands 


Nucleus commends are these which 
itself. They always start with a 
This period acts to distinguish 
l-Ccsd recue st s Csee 9«4*2»* Procram 


are processed by the nucleus 
period as the first character* 
nucleus commands from program 
Loading ), 


Entry cf Nucleus Commands 


Commands can be entered from the keyboard* 
currently executin'* program or from a file. 


card reader* the 


The keyboard command source employs two special function keys, as 
ln f^ure The left cursor key <<--} ij 1Jse d to provide 

QPTU 3 M l * er l Se functior U - r er ror correction. The L INF 
ey ls used at the end of a command to terminate the 

an try* 


9*4*1•1• •C Set Card Input Hcde 


This command is entered 


• C 


It causes subsequent commands to be read from the system card 

lf 0, - E ? a ? been c enfigured for the system (see CNFS 
ti lty, section Commands are punched left justified 

on successive cards, one command to a card. The format for the 
punched commands is exactly the same as that described for the 

availab'le e * c *' pt , that nc 1 '’ ne return function is needed or 
aval Iafc e. Commands are read until a .E (Fnd of File, section 

'/{'l kL ’ s ^countered. Control is then passed to the nucleus 
and keyboard command source* 
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Figure 9-1 DOS Editor Keyboard Layout 
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This command can fc p used to set up a DOS card reader input 
streamj which can* for example, automaticaIiy: read, assemble, 
and lead a program* 


9*4«1*2* *F End of File 


This command is entered as: •£ 

It is used to pass control to the nucleus and return to keyboard 
entry mode* Thus it is meaningful only when entered from a card 
reader or tape reader* 


9»4*1*3« *F Set r iie Command Input Mode 


This command is entered as: *F U.FILENAMF 

This command causes all subsquent commands to be read from the 
named source file* Commands in the file are written left 
just if ied* one command tc a line* Commands are automatical ly read 
until a •E or end cf file is encountered, at which time control 
is returned to the keyboard* Once a .F command has been entered* 
the disk containing the named file may net be dismounted until 
all of the commands have been read* 

The *F command may be contained within the file, but the effect 
is to simply pass control to the named file. There is no nesting 
of *F commands* 


9*4*1*4* »L and a N Set/Cancei Log Mode 


This command is entered as: .L 

Use of this command causes all suosequent commands and error 
messages to be logged onto the system printer* if one has been 
configured for the system (CNFGj section 9.8.2.2.)* 

This command is entered as! *N 

This command cancels the effect of the .1 command. Subsequent 
commands and error messages will not be logged tc the system 
p rinte r* 

In addition* a manual or abnormal beet cancels *L mode. 
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9*4»1.5* *M Operator Message 


This command is entered as: *M Message 

While processing commands from a batch source* such as cards or 
paper tape* it often becomes necessary for the operator to mount 
a disk or service a particular device. The *M command can be used 
to suspend processing and display an appropriate message to the 
operator until a particular action has occured* Processing 
continues when the space bar is pressed. 


9.4.1.6* .T Set Tape Input Mode 


This command is entered as follows: .T 

The .T command is used to initiate reading of commands from paper 

tape. A paper tspp channel must be configured (CNFG utility* 

section 9.8.2.2s) for this command to be legal. The format of 
command input from paper tape is standard 7 channel ASCII coding* 
The parity bit is ignored and may be ode* even or missing. Each 
record^ is Terminated by a carriage return (CR> character* 
Following the final record* there should be an end of tape (EOT) 

character* All ether control characters such as line feed* null 

or rubout are ignored. The actual end of iine sequence could be 
carriage return* line feed* carriage return or any other 
convenient sequence? 

The character underline or left arrow (ASCII X'SF*) has a soeciai 
function if it occurs immediately prior tc the carriage return 
chsrcCt p r* In this case* the entire line is omitted from the 
input and ignored* This effect occurs only if the underline 
character^occurs immediately prior to the CR character. In any 
other position* it is treated as a normal data character. 

Once the »T command has been entered* commands are read from 
paper tape until either a *F command is read or the EOT character 
is detected* at which time command input returns to the keyboard 
mode. 


9.4*1*7. .G and .1 Select Unit C/1 


This command is entered as: *0 

• 1 

The effect of this command causes unit 0 or 1 to be 
currently selected unit. The file directory of unit 
appear on the display. No line return is needed to 
commands* 
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9*4*2* Program Loading 


Object programs are loaded by using the following standard DOS 
f crmat • 

U*FIL EN AM E<.*GPTIO NS > <PAR AM FT ER 1 jP AR A ME TER 2 •• *> 

Th e in f o rm at ic n enclosed in <b rackets^ is a standard way of 
indicating that which is optional* It is used in this context 
throughout the SPD/DOS section* 

u: ^he unit on which the file resides* It may be 

omitted if the file resides on the currently 
selected unit* 

FXLFNAHF*. The name of an 0 file which is to be loaded* 
It may be abbreviated to the first two letters 
of the filename* If two programs have 
identical two letter prefixes (i*e* FilFI* 
r ILP2 ) the abbreviated form cf the FILENAME 
will cause the first (nearest to track 0) 
D rocr am to be loaded* All DOS utility programs 
have unique initial charactersj so that they 
ran always be leaded using the two-letter 
abfcreviation* 

OPTIONS: A series of letters (I.E., VOSI) delineated 

from the FILENAME by a comma and containing no 
commas or embedded blanks. Any of the' 26 
letters of the alphabet can be used and the 
erder is unimportantJ the program can 
determine which of the particular letters were 
set (refer to the SPD/DOS Programmers manual 
for a thorough discussion). The particular 
effect cf the specified options is determined 
by the loaded program* If net needed* the 
leading comma and options field may be 
omitted* Nearly all DOS utilities require the 
specification cf options upon loading* 

PARAMETFR: A string, of characters delineated from the 

option field by a leading blank* Mere than one 
parameter can be specified and these are 
offset from each ether by a comma* The loaded 
program can scan out the parameter field for 
the information it needs to execute* This 
field may be omitted if parameters are not 
required* 


Following execution of a program load command* the specified 
program is loaded and executed* DOS utilities return to the 
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nucleus upon err.cr detection or completion* Application programs 
may or may not return* Following execution of a procram which 
does not return automatica Ily* control may be returned to the 
nucleus by manually rebooting the system* 


9*5# SPD/DOS Reserved File-names 


The source file names AUTO and LIST* the object file name AUTO 
and the data file name WORK have special significance to the DOS 
utiIities * 

If a ciskette on unit 0 is booted manually or an abnormal nucleus 
return occurs and there is a source file named AUTO on unit 0* 
then commands are automatically read from this file as if *F AUTO 
had been specified. If there is an object file named AUTO* then 
it is loaded automatically as though the command AUTO had been 
given* If both source and object files of AUTC exist on the same 
-unit* the object file will preferentially be loaded* 

If the N option for ASSEMBLE had been specified and there is a 
source file named LIST on either unit* the assembler will 
automatically write the source listing into that filej 
preferentialJy choosing the unit, opposite to the source. 

The assembler also uses the data file called WORK for various 
processing chores during assembly* 


9*6* Error Messages 


If an error condition is detected during operation of the nucleus 
or of one of the operating system utilities* the alarm is sounded 
(if available) and the following message is displayed (and 
printed if the L mode is set): 

****F PRO R**** COD E = X XNN 

XX is the first two characters of the utility program name or NU 
for a nucleus error# NN is a numeric code from 01 to 99* 

The error codes produced by the DOS utilities and the nucleus are 
listed at the end of this section* 

The error condition is cleared by pressing the space bar* which 
always forces a return to keyboard command mode* Alternatively 
pressing Cj for continue* causes a return to the current command 
source* 
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9»7. Core linage Saved cn Soot 


khen the nucleus is booted in manually by pressina the boot 
button or when a p rogram makes an abnormal return to the nucleus* 
that part of the current contents of memory which is used by 
SPD/DGS (excludingJocations X 1 G000»- X 1 OGFF') is saved on track 
2 of unit 0 if unit 0 is net write protected* The saved cere 
image is unaffected by the operation of other utility programs 
(exceot FORMAT) or the nucleus. A manual boot has no effect on 
the image if unit 0 is write protected. Execution of other 
application programs* especially on the SPD 20 Family* may 
destroy the imaae. 


9*8* SPD/DOS Utility Programs 


This section describes the operation of the DOS utilities. Each 
utility is an object file which is loaded from the diskette on 
which it resides by the standard nucleus load command* possibly 
including options and parameters.* 

Following completion of a task* or upon detection of an error 
condition* each utility returns to the nucleus to indicate either 
normal termination or to return an error code. 

The^ load requests indicate which options or parameters are 

optional by enclosing them within <brackets>« 

The PCS utility programs are grouped into three categories: 
Development* Maintenance and Peripheral Support. 


9.8.1* V and M Option Note 


utilities suoport the V option (Verify). This option forces 
all diskette write operations to be verified by using the re-read 
check. Output to the WORK and LIST files cf ASSEMBLE is never 
verified* 

Free use of the V option slows down processing considerably and 
is very rarely necessary* This prevents the SPD/DOS utilities 
from operating at their maximum efficiency. 

One notable exception is the FORMAT utility* Here* the V phase is 
very fast and may be used to verify that all sectors have been 
correctly formatted. Utilities which affect cnly the directory 
may use the V option freely (e»g. ERASE* RENAME). 

DCOPY and PACK are fairly efficient when operatina with the V 
option set (50% loss of efficiency). It may be wise to use this 
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option in some situations Ce.g.* in-place PACK). The M option* 
available on COPY* DCOPY* FORMAT and PACK* allows the utilities 
to be loaded from a separate diskette. Thus* this option allows 
these utilities tc- operate on a single drive system. In addition* 
this option allows^ COP Y 3 DCQPY and PACK to be loaded from 3 for 
example^ a system disk and then operate on separate disks in a 
dual drive system. 


9.8.2« Development 


This section contains the DOS utilities which relate to prooram 
and diskette development. 


9.8*2.1• FORMAT: Format Diskette 


Lead: 

FGRMAT<*Optiors> Unit<* Disk -Name> 

Options: 

0 format File directory only* This causes the the formatting 
of the file area* tracks 3 to 63* to'be skipped* FORMAT 
can thus be used as an efficient way to clear a directory* 


Mount. Pause to mount diskette. Allows FORMAT to be loaded 
from, a separate diskette in a one disk system* FORMAT 
continues when the space bar is pressed* 

■ ormat and write Nucleus only* The formatting cperation is 
restricted to tracks 0 and 2 only. The files and file 
directory remain unchanged. This option may be used to 
reformat a defective nucleus or write a new version of DOS 
to the nucleus track* 

Verify. After.the entire diskette has been formatted* a 
verify phase will be initiated which will check to see if 
all sectors have been formatted correctly. Used to verify 
that the disk surface is undamaged* 


The FORMAT utility i s used to format a virgin disk so that 
subsequent disk operations by the nucleus and possibly the 
application program can be performed. Format also writes the 
nucleus code onto track 0 of the disk. All disks must be 
formatted correctly to run under SPP/DCS. 

Under some conditions* a diskette may not function correctly as 
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evidenced by its failure to boot properly or by constant return 
of disk I/O error codes* such as Read Check (see section 9*9** 
Diskette l rrors)» The FORMAT utilty /nay be able to rescue such a 
disk* FORMAT is loaded with the unit number of the diskette to be 
rescued^ and the V option set. FORMAT will enter an E phase* 
described in the following paragraph* if an error is detected. 

The configuration parameters written to the newly formatted disk 
are copied from those currently active. These parameters are 
descibed in the utility section. 

r 0RM AT DISPLAY 


SPD/DOS FORMAT 
Label 


U *DS KN AM E -X - <XX*XX) 

: : 22 s.».Cur rent Sector 

: 2 : 5 ••••••.Current Track 

2 2 2 •••••»*•••*Phase 

2 2 • »•««.*.«*.•»* s »•*DSN 




FORMAT operates in five phases as indicated on the displays 

M Mount. Pause to mount diskette to be initialized. This 

allows Format to be loaded from a separate diskette. 
FORMAT continues when the space bar is pressed. 

F r ermat. All sectors are formatted with initial contents of 

zero. The display continuously reports the current sector 
and track being formatted. 

V Verify. The success of phase F is checked. This is dene 

only if the V option is specified. 

w k'rite* The nucleus code is written onto the disk. 

Frror. Displayed if a Write Error is detected. FORMAT 
pauses so that the number of the track and sector where 
the error occured can be noted. Pressing the space bar 
causes return to the nucleus with the appropriate error 
code. 


If the diskette to be formatted has already been aiven a 
Disk-name* a s noted in its directory display* this parameter need 
net be given. In such a case* the old Disk-name is retained. 
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Exampie s 

FO*V IjDSKCI 

FOsH 0 

The diskette residing in unit 1 is to be formatted and verified* 
It will have the Disk-name DSKG1» 

l - 

The diskette on unit 0 will have its nucleus reformatted and- 
rewritten* The original Disk-name will be retained. 
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9.8*2.2. 


CNFG: Configure Diskette/Buffer 


Load: CNFG (No Options or Parameters Permitted) 

CNFG is used to establish new system peripheral codes in the 
diskette controller buffer and possibly write them to track 0 of 
the desired diskette, DOS uses these codes tc determine what type 
of equipment is available to its utilities* Therefores, the 
diskette buffer must be properly configured before any of the 
SPH/DOS utilities are used* Whenever a diskette is booted, the 
information in track 0 is written to the diskette buffer* Thus it 
is necessary to make certain that the proper system ccnfiguration 
parameters are contained in the diskette before it is manually 
boot ed* 


CNFG operates on a question and answer basis* The questions asked 
depend ^ cn the machine model in which CNFG is loaded* The 
following sections describe the questions and possible answers* 
They are not presented in any specific order* 


9»8*2*2*1* Action Required? 


G - Write parameters to unit 0 
1 - Write Parameters to unit 1 
S - Set New Parameters 
X - Fxit to Nucleus 

Answers 0 and 1 write the diskette buffer parameters to units 0 
and 1 respectively. Thus* these answers may be given tc simply 
propagate current parameters from disk to disk, or to write new 
parameters, established after entering S, onto disks. Once 
parameters have been written onto a disk, they will be written tc 
the diskette buffer whenever the disk is booted in* 

Answer S forces CNFG to further interrogate the user* The 
questions asked depend on the machine model and the various 
responses* As each question in this phase is answered, the newly 
set parameter is written to the diskette buffer. Upon comoet ion 
gt this phase, *Acticn Required? 1 is again displayed and a new 
set cf parameters may be in effect, though they are not written 
tc the disks unless 0 cr 1 is keyed in* Entering the $ key 
anytime during the interrogation forces a return to the first 
question, *Printen T ype?>* 

Answer X causes CN r G to immediately return to the nucleus. Any 
parameters set by responses to the utiltity, even though they 
were net written to the diskette, are in effect until they are 
modified by a manual or abnormal disk boot or CNFG* 
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9.8*2.2»2. Printer Type? 


For answers to this question, and to the related questions, 
■Controller Type?' and 'Printer Channel?', consult the 
specifications manuaI of the printer cr system in use. If no 
printer is used* answer N» 

After entering the printer and controller type* the user will be 
asked to supply pace depth and line width information. This will 

i_ aN prin1 :, ed output produced by the SPD/DOS uti Ities and 
should be compaticle with the current form in use. 


9.8.2.2*3. End Refresh? (SPD 10/20 only) 


Answer 0 for upper/lower case keyboards and 7 for upper case. 
This parameter is used by the SPP/DOS utilities to control the 
display. 


9.8.2.2.4* Screen Size? (SPD 10/20 only) 


Choose E for full screen* 30 X 64 display* or H for half screen 
15 X 64 display. 


9*8.?»2»5. Keyboard Type? 


Choose 1 for upper case only* 2 for upper/lc-wer case* i for 
upper/lower case converted (allows upper case only editing on an 
upper/lower keyboard)* 4 for IDES upper/lower case and 5 for IDES 
upper/l over case converted. 


9.8.Z.2.6. Additional Questions 


Other questions ask information concerning the existence of 
various peripherals* such as a paper tape reader. The questions 
simply request the assigned device channel of the peripheral’. 
Type N for each device net used. 


9-18 



9•8.2.3# ASSEMSLE/RASS EMBL : Assemble Source File 


Loads 

ASS FMBLF< *0 pt ‘tcns> S f i 1 e< * b < *0 f i 1 e <jLabe!>>> 

AS<jOptions> Stile 

RASSEMBL: Relocatable Assembly 

Load: 

R A'SSFMBL<jOpt icns> Sf i I e<,b/*Rf i i e <jLabel>:>> 

R A<_,0 pt ions > Stile ' 

Note the nesting of parameters. This specifies the parameters 
that may be omitted. 


Opt ions; 


A 

5 

C 

*0 

E 

F 

*0 




I 

K 

L 

N 

*0 

P 

Q 


Alternate Unit. The object or relocatable tile is 

generated on the unit opposite from that implied by the 
call* 

Soth pass* Print on pass 1 and pass 2* 

Clean# Enforce LIF G: IF/FNDF and deleted code are never 
printed* 

Definitions# INclude DOS standard definitions module. 
Use of this option can be avoided by iNcluding D<SD^FS at 
the appropriate location in the code. 

Frase duolicate object file* 

Full list# Enforce LIF 2 mode: AH IF/ENOFj» plus deleted 
code is p Tinted. 

Generate IN cede: Fnforce LIN 1 3 INcluded code is 
listed* 

Hold IN cede: Enforce LIN 0. INcluded code is listed 
only fo r errors « 

Inhibit object file production* 

Kill Hash comments. Enforce List 2 mode. Ejects and 
subtitles are used to format the listing* 

List* Fnforce List 3. Hash comments are listed. 

No Printer: Print source listing in LIST file. 

Omit. Omits literal cross references. 

Paper save. Enforce List 1: eject and subtitles are 
treated as comments* Hash comments are killed. 

Quick Assembly: XRFF 0# No cross reference is generated. 


Reference unassembled: Enforce XRFF 2. Cress reference 
for deleted IF/END F code is generated. 

Short List: Print only errors# 

Table of Contents. Shows the initial page number of each 
subtitle line# It is printed immediately before the 
listing of the first subtitle line* 

T?irfnr d ? l - eted . ccde: Fnforce LIP 1. Code deleted, plus 
IF/encf lines in false IF ranges, is not printed. 
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V Verify writes to object* WORK and LIST are never 

verified* 

X Cress Reference: Enforce XRE F 1* Collect cross 

references in assembled areas* 

* ASSEMBLE utility only 


ASSFM 3 LF and^ RASSEM 8 L are used to produce absolute and 
relocatable object cede from souce files* These utilities require 
that a Data file called WORK be established prior to their 
loading* The WORK File may be created by the CREATE utility* 

Fxamp1e: 

CRjO 45 establishes a 45 track data file called WORK on the 
currently selected unit* 

Use of the N option requires the establishment of a Source file 
called LIST pnor.tc the assembly* The size of the list file 

should be one and a half times as large as the source file 
itself* 


Example: 

CR^S 20 establishes a 20 track source file called LIST on the 
currently selected unit* 


The utilities will preferentiaIy select the WORK or LIST file cn 
t e unit opposite to the source if the files reside on both 

units* For optimum efficiency, the WORK file should immediately 
follow ASSEMBLE or RASSEM 8 L, though the utilities will work no 
matter how the files are positioned* 

JSSfMBtF searches the currently selected unit first when 
INciuamg a given nodule. Thus, maximum efficiency is obtained 
when the currentiy selected unit is set to that containing the 
relocatable file(s) prior to loading the utility. 

ASSEMBLE no longer defines DOS standard symbols. They can be 
incorporated into an assembly in one of two ways. The program 
must be assembled with D0SLI3 and the D option used which 
automatically INcludes D £ DE F S as line G of the assembly. Or, the 
program itself includes the OSDEFS module. Both actions must not 
be taken together or M flags will result. The latter method is 

preferable since it is more efficient and cleaner looking, 

documentatlon-wise» 

The b parameter must be given as four hex digits. If the b 
parameter is omitted, $3 defaults to 0. If the object file and 
label a re cm it ted, the filename and label are copied from the 
source file. Note the nesting of parameters shown in the load 

request (e.g, b cannot be omitted if ofile and label are given). 
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If the source program is contained on more than one disk* sfile 
is given in the formats 

Fi I ename.D isknamel .Mskname2 <*ni s kname3> 

Filename specifies the name cf a|j the files* which must be the 
samej and the unit on which the initial and subsequent fifes 
reside* 

Diskname specifies in sequence the names of the disks on which 
the files reside* As shown* up to three disks may be specified* 
The parts cf this parameter are separated by periods* 

During assembly* a pause will occur for mounting the disks* The 
diskette containinn the work file* the object file and the 
utility must NEVER be reloaded. 


E xampIes: 


C•AS CHESS 

AS * E$q DETOURS*19 65 *1 * WHO *GENERATION 
RAjA AL0T.DISK1*DISK2*FFFF 

The source file CHESS on the cur rent ly 
assembled* The object file is produced on 
carries the same file name and label* 

The source file DETOURS is assembled to produce the object file 
WHO which will carry the label GENERATION. SB is set to X*t965». 
Any previousi object file called WHO will be erased* No printed 
listing* except errors* will be generated* 

Thp source program is made up of two files called ALOT on aisks 
DISKI and DISK?*: IS is.set to X * FFFF *. The A option ensures that 
t e relocatable file is generated cn the unit opposite to the 
remount unit* as required* 


9»8*2*4* EDIT! Edit Source File 


seIected unit is 
the same unit and 


Load! 

Edit Existing File: 

ED IT<*Options> Input-fiIe*Output-fi1e*LabeI 

Edit a New File: • 

ED<*Options> *0utput-fiIe* Labe I 

Fxamine Existing File: 
cr D<*0pt i ons> Input-file 
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Options- 

E Prase Duplicate Source File 

V Verify Writes* Note! this option cuts efficiency 

considerably! 

Special Function Keys 


DONE * 


MERGES 

QUIT* 


COPY LINE 
COPY PAGE 

DELETE LINE 

delete page* 

DELETE CHAR 
HUP 

DUP FI^LD 

ER AS E FI EL D 

ERASE SCRN# 
INSERT CHAR 
INSERT LINE 
LINE RETURN 
REPEAT 
SEARCH 


SET TA3 
SET TAB* 
STOP 


TAB 


Copy remaining input file to output file* Close 
output file and exit* 

Merge new input file into output file* 

Delete remaining input file from output file. 
Close output file and exit* 

Copy 1 line of input file to output file. 

Copy pace image to output file* Read next page to 
screen* 

Delete 1 line of input from output file* 

Delete page image from output file* Read next 
page to screen* 

Delete 1 character at current cursor position* 
Duplicate 1 character from previous line* 

Duo i icate j until the next tab stopj the previous 
line* 

r rase from current cursor position until the next 
tab step. 

Erase screen image from output file* 

Inserts a blank into current cursor position* 
Inserts a blank line into current line position* 
Move cursor to start of next line* 

Repeat function of any key pressed* 

Search to line number or label* a specific line 
will be requested by EDIT. EDIT can then be used 
tc. automatically COPY/DELETE PAGE or COPY/DELETE 
LIN r until the desired line is reached* LINE 
RETURN cancels search mode (though not the actual 
search.)* The back-arrow can be used to backspace 
through the entered label cr line number* STOP can 
be used to immediately terminate the search. 

Defire start of new field* 

R emeve a I I tabs* 

Stop the current operation in progress* This key 
can be used to cancel a SEARCHorDONE 
command* 

Move cursor to start cf next field* 


The following keys repeat when held down: 


> Move cursor to right 

<- Move cursor to left 

* ^ Move cursor up cr down* 

* Upper-case function keys 
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The EDIT utility has three main purposes* It may be used to 
either edit an existing source file and write the edited text 
into a new output file or to create a new source file and enter 
text directly from the keyboard. The EDIT utility can also be 
used to simply inspect an existing file* in which case all write 
operations are inhibited. The mode which one enters EDIT is 
dependent upon which of the three parameter formats is chosen 
when EDIT is loaded* 

If EDIT is operated on an upper/lower case keyboard* and the 
system has been configured for such* then EDIT will accept 
upper/lower case text* 

EDIT provides for automatic search-and-edit up to a specified 
line. The SEARCH key is pressed and a specfic line number or 
labels cf up to 8 numeric or alphanumeric characters* is 
requested. Then* one cf the COPY PAGE/LINE or DELETE PAGE/LINE 
functions^ must be selected. EDIT will automaticalIy perform the 
selected function until the desired line is reached* STOP can be 
used to terminate the search at any time. 

When all editinc is completed* the user selects one of the two 
end—of—job commands 1 DONE or QUIT. DONE copies the remaining 
input fil e into the output file* QUIT immediately closes the 
file* deleting any remaining input file text from the output 
file. 


Edit also provides for merging another file into the output file 
or merging the input file into 'itself*. When the Merge key is 
pressedj a! 1 input is suspended and a new unit and file name is 
requested. When these are entered and the Line Return key is 
pressed* the named file becomes the input file, it is possible to 
name the previous input file as the MERGE file or to name the 
output file as the MERGE file. The new input file is selectively 
edited* by using the standard EDIT functions* 

DFLETE/COPY PAGE/LINE* until the MERGE file 


has been 


SEARCH and 
proc essed. 


When merging an output file into itseif* the user should be aware 
that it is not possible to copy closer than one disk sector. 


To leave the. MERGE mode* either the QUIT or DONE function is 
selected and input resumes frein the previous file* 


Notes EDIT makes every attempt to close the output file. In 
fact* an end of file and a last track of 63 is written 
to the output file immediately after it is created. 
This helps to ensure that* even in the event of a power 
down* most cf the file will be recoverable. 

UnrecoverabIe input errors do not terminate the edit. Instead* a 
message **SAD BLOCK** is read onto the screen ccrresponding to 
one or more unreadable records* The operator may use the keyboard 
to repair the errors 


9-23 



Blank records a r e deleted by EDIT* Therefore it is not possible 
to directly insert blank records into the output file* 

Examp les 

Suppose that a syntax error was detected by the assembler in line 
550 of a source program PPONS. The following commands may be 
entered in sequence to repair the error: 

FD 0*PP0NG*1.PP0NG*PINS-PONG V3*Q8 76-04-27-2400 

SEARCH 

550 

COPY PACE 

Make correction 

DONE 

Note that the output file is created on the unit opposite from 

^ 1 e * T ^ s allows us to retain both the original and 
edited files without having to change the filename* 

Now suppose that this program has been assembled* loaded and 
verified bug-free* Suppose it becomes necessary to attach PP0NG 
to the end of 3 main program called PP0NG1, MERGE can be used to 

solve this dilem as. 

FD 0*PP0NG1*1*PP0NG1* M AIN PROGRAM PP0N5 
SEARCH 
FPRGRM 
COPY PACE 
MERGE 
1 

PP0N G 

DONE 

DONE 

Note that SEARCH is used to COPY PAGE until the label EPRGRM is 
found* This is where the subprogram will be merged* When MERGE is 
pressed* the unit on which the new file resides is entered* 
followed by the filenames The entire file is copied into PP0NG1 
by using D0N P * DONE (QUIT could have been used as well) is used 

again to exit from the main edit* 


9*S*2*5* CREATE: Create File 


Lead: 

CRFATF*0ptiens Nc-T racksjlnterIace*Filena me*Labe I 
CR*0ptions Nc-tracks 

Opt ions: 
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n A Data file is to be created# 

£ Erase existing duplicate file* 

S A Sourcp file is to be created* Normally, this option 

is used cnly to create the LIST file required by the 
ASS^M5L C and RASSEMBL utilities (N option set)* 

V Verify all write operations* 

Notes If neither D or S is specified, D is assumed* 


The Create 

utility is 

used to 

est ab{isn 

a new data or source 

file* The 

5 

1 te rnate 

form of 

the lo3d 

request allows default 

values to 

b e 

sp ecified 

fer the filename 

and interlace factor* 

Note that 

the 

number of 

t rac ks 

(No -t racks ) 

is always required* 

Opt ion 

Int er1 ace File 

Label 




. Factor 

Name 



D 


n 

WORK 

none 


S 


11 

LIST 

none 


Ex a mp 1 e: 

CR 

* 0 55*5,SPOOL,MAIN 

SPOOLING FILE 


CR 

15 





A 55 track Data file called SPOOL will be created on the 
currently selected unit and carry the given label* The interlace 
factor wilI be set to 5* 

A 15 track data file called WORK will be established on the 
currently selected unit* carrying an ail blank label. The 
interlace factor wil! be set to 0* 


9*£»2*5*1* Rescuing a Disk 


CREATE can be used to rescue a disk by attempting to create a 
file over the disk area in question. If CREATE finds bad sectors* 
it will attempt itc reformat them. If it succeeds* a CR10 error 
cede, file area exhausted will be returned. The return of any 
other cede means that the disk is defective and a backup copy 
should be used* 

Example: 

CR 80 (Make certain we create past last track) 

Error Return: ***E R R 0 Rxxx C0DE=CR10 

A ‘file area exhausted 1 error is returned, meaning CREATE has 
either found no bad sectors, or it has reformatt ed the 
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questionable sectors* 

9*8*3* Maintenance 

This section includes the utilities needed tc maintain the 
developed files and diskette* 

9*8*3*1* DCOPY: Diskette to Diskette Copy 


DCOPYOOpti cns> Frcm-fi 1 enamejTo-fi i ena me<^L 3 be l > 
DCOO pt ions > FilenamejTo-Unit<jLabeI> 


Opt ions • 

D Data file tc be copied* 

E Erase file with duplicate filename. 

M Mount diskettes Load DCOPY from separate diskette® 

0 Object file tc be copied® 

R Relocatable file to be copied® 

S Source file to be copied® 

V Verify all write ope rations® 


DCOPY is used to ccoy a file from one diskette tc another® DCOPY 
can be loaded from a diskette ether than that which contains the 
file to be copied* by using the M option* DCOPY pauses until the 
Input/Output diskettes are mounted and resumes execution when the 
space bar is pressed* The M option can be used to copy files in a 
single drive system* 

Example: DC^MO R r XjO 

DC*R G.UTILjI.ULIBjUTILITY LIBRARY 76-07-23-0945 

The file REX on unit 0 is to be copied onto another diskette in a 
cne-drive system* "copy copies the file in half-sector chunks* 
pausinc for the diskettes to be mounted* until all of REX is 
copied® 

The relocatable file UTIL is copied into the file ULIB which 
DCOPY will Create on unit 1® It will carry the named label® 


9»8*3®2» ERASE: Mark File as Erased 
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Load: 

FR AS^<*0pticns> File1*File2.»Fiie3s*** 

Recover Erased Fil'e: 

RE*E<0ptions> File 

OPTIONS 

0 Data file to be erased 

I Ignore Frrer: Not used in RE utility 

0 Object file to be erased 

R Relocatable file to be erased 

S Source file to be erased 

V Verify erase* 

The ERASE utility is used to mark a file as erased <*)• The space 
occupied by this file is not reclaimed until the diskette is 
PACKed. The RENAME utility can be used to recover a file marked 
as ®ra sed* 

Normaliy it is considered an error to erase a non-existant file* 
This situation is often encountered when ERASE is used to mark a 
string of files as erased* Therefore the I option may be set to 
ignore this error condition* 

EXAMPLE: ER,V0IS TFLE*TELE1*TEL£2 

R p *F$ TELE 


The object files T r LF s TELE 1 and the source file TELE2* TELE 
will be marked and verified as erased* The fact that there is no 
object TFL>-2 or source TELE1 wi I l be Ignored by ERASE 

The source file T^LE will be marked active in the file 
directory• 


9»8*3*3» PACK: Pack Diskette 


Load: 

PACK<*0ptions> Unit 

To Pack From 1 Diskette to Another: 
PA<*0ptions> Urit*Unit 

Opt ions: 

D Retain all Data Files 

M Pause to Mount Diskette 

0 Retain all Object Files 

R Retain all Relocatable Files 
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S Retain all Source Files 

V Verify krites 

Note- If none of the D* 0j S or R options are specified* all 
active files are retained* 

PACK is used to remove all erased files from the directory and 
pack the disk into the reclaimed space. It may be possible to 
rescue an accidently packed diskette by usina the XDISK utility 
to rewrite the directory* 

PACK can be used_ to pack from 1 disk to another selectively 
retaining all active files or only active source* object* data or 
relocatable files* Thus the utility provides an efficient method 
for producing diskette copies* 

If an error occurs while copying a file* the file status on the 
output unit is set to *?** error* PACK always completes its 
operations before signalling an error and returninG to the 
nucleus* 

No attempt shou!d be made to stop a PACK operation prematurely. 
This will cause the file directory to be written incorrectly* 
making any attempt tc load or manipulate the files futile. 


Example: PA*V 

P A* VO 0*1 

All erased fifes are deleted frcm. the currently selected unit and 
the disk is packed into place* All write operations are verified* 

All active object files are packed from unit 0 to unit 1. All 
writes are to be verified* 
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9.S.3.4* LIST! List File 


Lead s 

LIST<*0pticns> <file> 

LI<*Options> <Lfnit> 

Options! 

A Align* Enter printer alignment sequence. This must be 

the only option* if if is specified* 

n File to be listed is a data file. 

H Hexadecimal. Listing for data or relocatable files 

given in hexadecimal. 

I Ignore errors. Bad data records will not cause error 

termination. 

N Number. Lines of S files will be numbered. 

0 Object. File to be listed is an object file. 

R Relocatable. File to be listed is a relocatable file. 

S Source* File to be listed is a source file* 


The LIST utility is used to list tiles. It also has an option* A* 
to generate printer alignment data. LIST can also be used in the 
alternate form of the load request to list the file directory of 
a particular unit. If the unit is not specified* the currently 
selected unit directory will be printed. 

A printer must have been configured (CNFG utility) for LIST to 
function. 


The use of the Adoption generates alignment data for the printer 
ana is used only in the keyboard command mode. For a character 
printer* the operator is invited to type an F or V for form eject 
or vertical tab alignment respectively. Fora line printer* a 
digit frojr. 1 tc 4 1s entered to align the correspoding forms 
channel. The S key prints test data with no form feed. The 
alignment data may be generated repeatedly until the x key is 
pressed tc> return tc the nucleus. The printer must be in its 
EAOY state (selected) for any of the alignment commands to be 
operative* 


More than one file of the same name but different type may be 
listed by specifying mere than one file type option (D*0*R or S>« 


Data files a r e listed by sector according to the SIF for the 
fl, e. Data and files are listed in ASCII unless the H option i< 
specified. Object files are listed in hexadecimal by sectors 
Relocatable files list the module directory and also the 
hexadecimal sector data if the H option is given* Source files 

are listed by logical records and numbered if the N option is 
specified. 
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EXAMPLE: LI,SON DOC 

LI 1 

The source and object files of DOC will be listed. Source records 
will appear numbered* 

The file directory of unit 1 is to be listed* 


9*8*3*5» RENAME 5 Rename Fi le 
Load: 

RENAME*Options 0id-name<*New~n3me><jLabel> 

Options! -W-/'; 

R ename data file* 

Rename erased file* 

Rename object file* 

Rename relocatable file* 

Rename source file* 

Verify all write operations* 

Note: Exactly one of the 0,0 ,R or S options must be specified. 

The RENAME utility is used to rename an existing file. The file 
may be^active or, if the E option is set, erased. If several 
erased files with the same names exist, only the first will be 
marked active* 

In no case is it possible to use REMAKE to generate two active 
tiles of the same name and type* 

Example: REjS OLDjNEWjTHIS FILE HAS BE RENAMED 

REjO SAMjjTHIS FILE HAS BEEN RELABELED 

The source file OLD is to be renamed and given a new label* 

The object file SAM is to be given a new label* 


9*8»3*6» XDISK: Examine Diskette 
Load: 

XDISKOOptions^ No Parameters Permitted 
Opt ions: 

F Fu buffer* Display entire 256 byte diskette buffer 
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ares* Normal ly* only the 123 byte sector data area is 
disp i ay € d 9 

V Verify ail writes to the diskette* 

Special Function Keys: 

H Hard copy of screen written to printer. 

L Position cursor to the left# 

P Modify cursor position* Two hexadecimal dioits are 

entered after the P function is selected* 

R Position the cursor to the right* 

S Enter sector number* as two decimal digits* 

T Enter track number* as two decimal digits# 

U Enter unit number* in decimal. XDISK assigns the unit 

number to be the currently selected unit* 

y Write hexadecimal data* as modified on the screen* to the 

diskette buffer* 

X Ex it to nucIeus# 

XDISK is used to examine and alter the data contained on the 
diskette. XDISK works on a sector by sector basis* reading data 
from the selected track and sector to the diskette buffer.XDISK 
displays the sector data area of the buffer* but will disolay the 
entire buffer if the F option is set during the load request# 

XDISK also displays the current unit* the current track and the 
current sector being examined* The data appearing on the screen 
may modified by positioning the cursor ever the desired byte* 
using one of the L* R or P function keys* and entering the new 
data* in hexadecimal* When all modifications have been made to 
that sector, the V key is used to write the new information back 
onto the diskette* 


XDISK displays the status of all read or write 
performed on the disk in the ERROR-N field* where N is 


eperations 


0 Noerror* 

1 Search error* Sector not found* 

2 Read or Verify error* 

3 Device inoperable* 

4 Track number is out of range# 

5 Unit is write protected. 


Hpfor** ne t 26 i° XDIS £ 1s t0 i nS pect a disk that has become 
d - feetive» It also may be used to rescue a directory which has 

been destroyed or altered by an abnormal PACK or FORMAT 
operation* In this case* the track positions of every fil<= must 
be known so that the directory can be reconstructed properly* 
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It is necessary tc recover a file which has been accidentaly 
erased and packed* The file was at the end of the directory and 
was net written over* A! I the vita} informat ionj first and last 
track location* interlace factor* filename and label are all 
known* Therefore it is possible to use XDISK to rewrite this 
entry in the file directory* which is located on track 1 of unit 
1 • 


XD 

Load XDISK 

U 

1 

T 

Select unit 1 

Se 1 ect t rack 1 

01 


S 

Search for end of directory 

00 

s 

Not here 

05 

S 

Not here ~ 

10 

Rewrite entry 

End of directory at sector 10 

W 

Write tc disk 

X • 

Exit 


9 *8*3* 7, ZAP: Pa tch/Examine Object Program 


Load: 

To Patch/Fxsmine and Store into New File: 

ZAP< s Opt ions> ifiIejofiIejlabe1 

For In Place Modification: 

ZA<jOptions> ifile 

To Examine Core Image after Breakpoint or Boot: 

ZA<_>0pt ions > 

To Save Core Image in a New file 
ZA<*0pticns> *ofile*iabei 

Options: 

A Alternate Work File* Unit 1 is used as the work 

file* 

F Erase duplicate object file* 

T Three* Three* instead of four digits are required to 

specify an address* Useful in small programs CCNFG 
10 or 25)* 

v Verify all write operations* 
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ZAP is a multi -purpose utility that allows the programmer to: 

* Inspects modify and restart the core image saved on 
a manuaI or abnormal boot* 

* Patch an object program* 

* Copy s program from one externa! medium to diskette 
or 20/20* 20/30 cassette* 

* Vrite a program directly in machine code* 


9*8* 3*7*1* Efficient Usage of ZAP 


ZAp . us f s tile track 2 of unit 0 as a scratch area* unless the A 
option is set which causes the utility to use unit 1* ZAP loads 
and stores segments^ between the work area and the input and 
output files* Thus* it is mere efficient tc have the work file on 
the unit opposite to the output file and input file* 

A good rule of thumb to remember when using DOS utilities in 
general* i s that a drive to drive copy is always more efficient 
than a one-disk copy* 


9*8»3*7*2* Pa t ch/Examine Program 


To examine and patch a program* ZAP can be loaded usinc one of 
the two forms: 

ZA<*0ptions> Ifile*0file*LabeI 
ZA<*0pticns> Ifile 

The first format is used to store the modified program into 
another file* preserving the original program* 

If in place modification is desired* that is* if the patch is to 
be stored into the input file* the second format is used* 
Alternatively* if the modification is net to be stored at all (if 
the program is simply to be started) this form may also be used 
to load ZAP* 

To perform the required modifications tc the input file the 
following procedure is used: 

L Load the program (or segment nn* as required) into the 

core image* 
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jump to a patch area 


Aaaaa Set the desired address aaae* 

Kdddd Modify to the required contents* A 
is a possibility* 

S a aa a * a a a a 3 ee <?e j K nn^ 

Store modified prop ram or segment into the output file* 
or if none was specified* into the input file* Note that 
the a bb re visted command 3 Snnj must be used if no output 
file was specified (in place modification)* 

Jaaaa Start core image at aaaaj or if not specified* start at 
the entry pcint as read from the input file* Note that 
many times it is desirable to start the core image 
directly after modification* eliminating the S step. 
This allows one to check the effectiveness of the patch 
before making patches permenant* 


Also* when patching many programs* 
compute an absolute address when 
relocatable address* This is solved 
base tc the required offset* 


it may become necessary to 
all that is known is the 
by setting the relocation 


For instance* suppose that the source listing of 
assembly showed that the address where a module of 
code was inserted (using the IN pseudo-op) is X’AOO 1 
as the relocatable base! RAQO* N 0 W 3 any relocatable 
be specified in terms cf the absolute address 
command APaaaa* The effect is to add the relocstabl 
the re location base and produce an absolute address! 


an absolute 
re Iccata bl e 
• This is set 
address* can 
by using the 
e address tc 


AEAE 

RAOC 

M 3CC0*R0120 

The modification sets a jump command to relocatable address 120 + 
AGO = B?0* 


Any addresses appearing in any command may be given as a 
relocatable address Raaaa and the effect is to add in the current 
location base (e*g* m the alternate form of the Aaaaa command: 
bRaaaa* where b is a blank* 


9*8*3.7*3* Breakpoints and Saved Cere Image 

When debugging a program * it is often helpful to know the 
contents of the ACR and Index (Cursor) register at various points 
in the program* ZAP cap be used to place Breakpoint instructions 
at the point where the ACR and Index are to be displayed* This is 
done by using the Baaas command: 
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ZA FILE 

802EE 

J10G 

Program is executed until breakpoint 
ZA 

ACR and Index displayed at breakpoint 

The cere image is then started using the jaaaa command and the 
program is executed until the breakpoint is reached. Control is 
passed to the nucleus by an abnormal boot. This saves the core 
image* which can be tested by ZAP. ZAP is loaded without 
specifying parameters* An automatic T instruction is executed and 
the contents of the ACR and Index Register are displayed at the 
breakpoint* 

Use of Z AP * s breakpoint feature requires that the DOS subroutine 
0 <8 P 0 y R be included into the main programs 


IN 

DO SL IS*D<SP0yR 

INCLUDE 

DOSLIB ROUTINE 

IN 

D0SL IE *0<5SBPW 

USED BY 

D8P0WR 

IN 

OOSLIBjDSURPF 

. * * 


IN 

DOSLIB,DGEXIT 



OR 0 

$X-2 

SET DtS P0 WR RESTART LINKAGE 

DAC 

D-SPO WR 

. • . 



9.8*3*7.4* Copying Programs from Peripherals 


It is possible to use ZAP to transfer a program from other 
external media* such as paper tape* to diskette or cassette tape. 

The procedure for achieving this requires the use of ZAP*s third 
formats 


ZAPOOpt ions> .»0 f i I e* Label. 

Note that a label is required in this case. The program to be 
copied is loaded from the desired peripheral* a paper tape 
loader* say* and a manual boot is initiated. This saves the core 
image for ZAP to process. ZAP is than leaded and the following 
command is given: 

Saaaa»aaaa*eeee*00 

This will save the specified region (s) of core in Ofile. Note 
that it is necessary to determine in what regions cf core the 
program resides and to determine the entry point. It is also 
possible* on the SPn ZG/20 and 20/30 models* to store the program 
on cassette in fcocstrap loadable form by using the W command. 
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It is sometimes useful to clear core before an external load* 
This is achieved by Ioading ZAP* c Iearing the core image* and 
then physically loading* but not startings the images 

' ZA 
" Z 

. % X 

note that some ^ programs won't work if they have a self- 
destructing initialization routine* One possible solution* for 
the paper tape format* is to cover the blank end record cf paper 
tape with self adhesive tape. In the punched card format* remove 
the last card. 

Programs can be entered in directly* via ZAP, in machine cede. 
The desired entry point is set* typically X'100** a n d a series of 
modify commands are given tc enter the program. It is useful* and 
less error—prone, to have these commands read from a file. For 
example* the following commands are stored in a file called Ts 

ZA*T *H ELP,TFS T PROGRAM Call ZAP 

* 1Q0 Set origin to X*100' 

M C8 42*B 900 Code 

S100.103*100*00 Store 

Start up 

To enter and start this program, the command .F T is given. 


9.S.3.7.5.- ZAP Considerations 


When the output file is closed (J or F commands) and if there is 
an input file specified, then all segments of the input file 
which have not been stored by S commands are copied unchanged to 
t e output file. In the case of the J command, subsequent segment 
loads will be from the new output file. 

Ncta that when an S command is given with no address ranges, for 
example* in the case cf an in place update (Snn), only those 
areas originally in the program are stored. The following areas 
wiIi NOT be stored* 

* 8S S areas* 

* Areas skipped by 0RG commands* 

* Bytes skipped by word alignment* 

* Areas outside the bounds of the program* 

Attempts to modify such areas and then store the result do net 
work and give no error condition. Always use the full form of the 
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Store command when patching a program* 

ZAP uses a work area (track 2) cn unit 0 to store the current 
core image C4K ); thus unit 0 must not be write protected* Neither 
the utility programs (except FORMAT and ASSEMBLE/RASSEMBL* see 
note below) nor the nucleus disturb this image* except cn a 
manual or abncrms 1 boot » Thus if ZAP errors out* it may be 
restarted without losing the core image being worked on* However* 
the current output file may be lost* 

Version 7 of the assembler sets the unused portion of the literal 
ares to X*FF», This can make a nice patching area when debugging 
aprogram* 


Tc save the image which is contained in core* it is necessary tc 
follow this procedures 

ZA *SA VF *LABEL 
Cssss 

SQ10.C. 7FFn*Qiao*CO 
E 
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9 *8*3* 7* 6* 


ZAP Commands 


Note: All ZAP commands* except X snd a form of a* are entered 

using the standard SPD/DOS Line Return Key. 

In addition* ZAP commands can be read from a file* They are 
stored* left justified* one command to a line* in the forms given 
below* Performing a ZAP run in this manner has the advantage of 
keeping a permanent record of the changes performed* It*s faster* 
too* 


A aaaa 

basa a 


Set Hex address aaaa as the current address® a 3 aa 
may be three or four digits* 

An alternate form of the above command* A blank 
<b)^ followed by four hex digits (three if T 
option set) which sets the current address* No 
line return is needed to enters this command* 


A breakpoint instruction* X»7FFC»* is placed at 
the current address* See the discussion of 
breakpoints for use of this command* 

Place a breakpoint at the specified address aaaa* 


Specify a logica1 core size* ssss* that is 
smaller than the actual physical size* This is 
the core size that will be written to the output 
file (e*g* 3FFF: 16K* 7FFF: 32K* FFFF: 64K) 


Db<t ext> 


Dump all core onto printer with message <text>» A 
blank (b) separates D from <text>* 


03333*3333* * »•* b < t eXt) 

Dump from specified region(s) of core aaaa*aaaa 
<text> may be supplied as a header and must be 
separated from the last address by a blank (b)# 

~ £nd ZAP run* Close output file and exit* 

^ Load core image* Zap terminates processing with 

the core image loaded* but not started* The 
machine waits in a DISABLED spin* The output 
file* if any* is closed befcre the wait occurs* 

J Control is passed to the program entry point as 

read from the input file* Valid only if an input 
file was specified* 

Jaasa Control is passed to location aaaa* The output 

file* if any* is closed before the jump* 
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Jaaaa <*Options> Parameters 


Start execution of core image at aaaa* Options 
and parameters are made available to the program 
just as if a nucieus load command had been given* 

J<jCptions> 

Parameters 


As above* but control is passed to the entry 
point as read from the input file* 

K 

Causes the contents of tne current address to be 
set as the current address* The- contents of that 
address is displayed* This can be used for 
tracing linked lists* 

Lnn 

Load segment nn (two hex digits)* If nn is 
omitted* the main or only segment is loaded into 
the core image 

M d dd dj dd dd •• 

Th e^current address and the words follcwino are 
modified to contain dddd (four hex digits)* 

N 

Next address* The next word is set as the current 
address* 

P 

Previous address* The previous word is set as the 
current address* 

R 5 S3 3 

Set Relocation Base* See the discussion of 

Relocatable addresses for an explanation of this 
command* 

S 3 333*3335 * % 

• * eee <=* nn 


Store segment nn at aaaa to aaaaa* Enter at eeee* 
In this case* a segment may only be stored once* 
As shown* more than one region can be stored* 
This command is not valid unless an output file 
is specified* 

S<nn> 

Store segment nn for in place update* This is the 
on fy form allowed when no output fi1e is 

specified* in which case it permissable to store 
a segment more than once* As shown* nn may be 
omit ted* in which case the currently loaded 
segment is stored* 

T 

Display registers at breakpoint (if any). 

Vdddd 

Verify the current location to contain dddd* 
Terminate ZAP run with error if not* 

Wa aa a»aa aa •«« 

t * * eeee * c 


The command is used on the SPD 20 Family series 
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to write the specified regions Cup to 7) onto the 
2C/?0 or 2C/3Q cassette icad tape in debug dump 
form suitable for boot loading* C is a digit 
giving the number of copies to be written (from 1 
to 7j normally 5)* As shown* more than one region 
may be stored* 

Immediate exit* The output file is not closed* 
That^part of the core image saved on track 2 
remains intact* Segments stored in core may be 
lost* 

Clear core image to X *00*• 
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9«8«4* Peripherals 


Four DOS utilities are particularly suited tc peripheral 
management# These are: COPY* TMOVE* UPDATE and VERIFY, 


9.8.4*1. COPY- Copy File 


Lead: 

COPY ^Options From-f i le* To-f i l e<*Label > 


Copy Source File from Current Command Source: 
C0*S<0pticns> jTo-fiIe*LabeI 


Copy Diskette Fi1 9 

COjOpticns FiIejunit 


Opt ions : 


A data file is to be copipd# 

Erase file with duplicate file name. This is 
meaningful only if the To-file is a diskette file. 
Logical copy. See the discussion for an explanation. 
This is valid only in the disk to disk case. 

Mount. This option is valid only in the disk to disk 
case. Allows COPY to be loaded from a separate disk. 

An object file is to be copied. 

A relocatable file is to be copied. 

A source file is to be copied. 

Verify. Meaningful only if the To-file is a diskette 
file. May also be used to verify multiple copies of 
punched paper tape or punched card output. 


The COPY utility is used to copy a file to and from a »ide ranos 
of external peripheral devices. It can also be used to copy'; 
file from one diskette tc another. Koveverj OCOPy should be usee 
in this case. 


It should b e no te^ that the ZAP utility has the capability of 
writing core images as object files on diskette and also buiidinc 
core images from object files. This may be used as an additional 
mechanism for moving object files to and from external media in 
formats other tnan those supported by the copy program. 


To copy files to the SPD 20/20 or 20/30 built 
use COPY. Instead ZAP (section 1.8.3.7.) and 
be used. 


-in cassette* do NOT 
its V command must 
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To designate external peripheral devices other than the diskette* 
the From-iile and To-fi!e parameters are given in the foilcwins 

T ft ftffl • * 


• TTC <» NNN> Where C is the hexadecimal device channel and IT is 
the two letter device type shewn below* NNN is three 
decimal digits specifying the number of copies to be 
punched* It is used only when the To file parameter 
specifies s paper tape or card punch* or when the 
copies are being verified ir, which case the devices 
are a paper tape or card reader* 

PP 
PR 
CT 
MT 
CR 
CP 

The following sections describe the operating procedures to be 
used with the various peripheral devices* 


9*8*4*1*1* Paper Tape Inputs PR 


The paper tape must be positioned at the start of the file to be 
read or on the leader* Source files and command files are in the 
same format except that source files may use the back-slash \ as 
a. tab character. Tab steps are set to 1-10-1 6-3C for use in 
assembly programs* Object format is identical to the output of 
the K716 assembler* If a bootstap loader is present* it is 
skipped* A C020* error reading external medium) is posted if a 
checksum error is encountered* 


9*S*4*1»2* Paper Tape Output* PP 


The output generated is compatible with the paper tape format 
described in the preceding section. It includes a ICO character 
null leader at the beginning and end of the tape* Output to the 

paper tape punch may be verified via a special use of the V 
option* 

Following a copy to a paper tape punch* the verify may be used as 
follows* Manually remount the tape on a paper tape reader on 
channel 12* (channel) 1 on SPD 10 series) and verify the copy bys 

COjOV 1•X *•P RC•nnn 

Where X is the original From-file and *nnn the number of copies 


Paper tape Punch 
Paper tape R eader 
Cassette Tape 

Magnetic Tape- 1/2 inch* 9 track 

Card Reader 

Card Punch/Reader 
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to be verified* 


9*8*4*1*3* Cassette Tape Inputs CT 


Files are read in s format compatible with that generated by the 
cassette tape output* described in the following section* Error 
reading external medium is signalled if the tape is in manual 
modej or if it stalls during read* or if a dropout or parity 
error is detected* This applies only tc the modej T13-G1 cassette 
unit apd not to the SFD 20 family built in cassette tape drive* 


9*8*4*1*4* Cassette Tape Output! CT 


One file is_ jvritten onto one cassette* The cassette is rewound 
before starting if necessary* The format for source files is the 
same as that used by the SPO cassette tape assembler and editor. 
Object files* which are not compatible with the cassette tape 
assembler* are written in 512 byte blocks. For unsegmented 
programs* the output includes a boostrap leader which uses device 
address 12 on the SPO 20 Family machines* and device 1 or 3 
(whichever is ready) on a 10/20* A C021* error writing external 
medium* is signalled if the tape is in manua I mode* or if it 
stalls during the write cr if it is write protected* 


9*8*4»1»5* Magnetic Tape Input? K7 


The file is read without positioning the tape* thus the tape must 
be positioned tc the beginning of the desired file using TMOVE 
(section 9*8*4*2*)* After reading the last file* the tape is left 
positioned ready tc read the next file* Source file format is 
compatible with that used by the H716 assembler system* Error 
reading external medium is signalled if the tape is off line cr 
if the formatter is switched off* or a reao error is encountered* 
cr if the fi le format is incorrect* 


9*8*4*1*6* Magnetic Tape Output? HT 


The file is written without positioning the tape* thus the tape 
must be positioned tc the beginning of the desired file using 
TMOVF* After writing the file* two end of file marks are written 
and the tape is left positioned following the first end cf file* 
ready to write the next file* Error writing external medium is 



signal led is the tape is offline or the formatter is switched off 
or a write error is encounte red* 


9*8*4*1*7» Punched Card Input* CR or CP 


On the card reader* the deck is loaded into the hopper and the 
RESET button is pressed* On the reader/punch* the deck is loaded 
into the primary (rear) hopper and the reader reset* Following 
reading the last card (*E end of file)* this card must be run out 
manually on the reader punch* Error reading external medium is 
signal led if a checksum error is detected in an object deck* 
Other card reader errors cause COPY to pause for appropriate 
operator intervention* 


9»8*4*1*8* Punched Card Output! CP 


The printing-reader-punch must be cleared and reset before 
starting* Blank cards are fed from the secondary (front) hopper* 
In the case of object files for unsegmented programs* the output 
includes a bootstrap leader* This loader is compatible with the 
reader-punch or the card reader* It uses the same device address 
as the punch unless a fourth digit is given on the device 
specification* 

For example* #CP36 specifies a file to be written to the punch on 
channel 3 with fcoostrap loader for device address 6* Error 
writing external medium is signalled if an attempt is made to 
punch on non blank cards* In other error situations* COPY waits 
for appropriate operator intervention* 

COPY can also produce multiple copies from a paper tape punch 
with verify* 


9*8*4*1*9* Error Detection 


In genera 1 * COPY attempts to complete the copy operation even if 
errors are detected* the appropriate error code beinc posted upon 
completion. If the output is a diskette file and such an error 
occurs* the file is closed and marked with ?* error status* 
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9*8*4* 1*10* Examples 


CO jR E AFILEjI 
CGjO 0*MT3j *CT4 

CO j D 0*ICUjI.IMUR ESj version two 
COjS •CR6j1*FILENAMEjVIKING II 

The relocatable file AFILF on the currently selected unit j 
pres umed to be unit Oj is copied to unit 1 with the name and 
label unchanged* Any previous relocatable file aFILF cn unit 1 is 
erased* 

An object file is ccpieo from a magnetic tape on channel 3 tc a 
cassette tape on channel 4 with the original label* 

The data file ICU cn unit C is copied to unit 1 where it is named 
IKURES with label VERSION TWO* 

A punched^ card source file is copied from a card reader on 
channel 6 into FIL c NAME cn unit 1> It carries VIKING II as a 
label* 


9*8«4*2* TMOVF: Tape Mcvs 


Load: 

TH<jOptions> Channe|<^N> 

Option s • 

B backspace fi I es» 

F Forward space files* 

L List directory* 

Notes At most j only one of these options may be present* 


TMOVF is used to position a magnetic tape unit to a particular 
file. It is used in conjunction with the COPY utility to manage 
mu 11ip Ie files cn a single tape* TMOVE a I sc contains a directory 
listing cpticn* 

The form of the command used to position the tape to the start of 
a specified file* numbered from 1 j does not take any options: 

TM ChanneI*Fi1 e-number 

Tc backspace.* the B option is used* The number of back-space 
operations performed is given by File-number* Backspacing one 
file involves moving backwards one fife mark and continuing to 
move backwards until the next file mark or beginning of tape is 
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reached* If a file mark is reached* the tape is spaced forward 
past this mark. 

Forward spacing operations are similar. The F option is used to 
forward space files from the current position. 

To list the initial record of every file on the tape* the L 
option is used. The initial record is typically a label record. 
Thus this command acts to give directory listings. The tape is 
rewound following completion of the listing. It is assumed that 
the last file is terminated by a double end of file mark. 

Examples;, TM 3*4 • 

TMjB 3*6 
TM*L G 

The tape on channel 3 is positoned to file 4. 

The tape on channel 3 is backspaced 6 files. 

The tape on channel 0 is listed. 


9.8.4.3* UPDATE: Patch Edit 


Load: 

UPDATE<*Cptior.s> If i l e* OfiI e* Labe I 
Options: 

c Erase any duplicate source file. 

L Log update input lines to the printer. 

V Verify ail diskette output. 

UPDATE is used to edit a source file in batch mode. The update 
data is taken from the current input device (cards* tape* file or 
keyboard) depending on the current mode. 

UPDATE Command's: 

SKeyword Comments 

This is the UPDATE command format. $ indicates an UPDATE command 
is to follow* which is designated by the Keyword. Comments can be 
specified on any UPDATE command line and do not affect 
processing. 

$=any single character 

The UPDATE command character will be replaced by the indicated 
character from now cn* This character may be changed by another 
occurance of the command* Character=New character. 
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$* Text 

Text may be inserted into the UPDATE command stream by this 
command* 

SSany-character 

Subsequent occurances or the character & wiii be replaced by the 
character indicated* $55 resets the normal mode* 

Snjfn 
$n 
$* m 


These commands control Ifile to Ofile copys n indicates to what 
line (card image) text will be deleted (non-inclusive)• m 
indicates tc what line text will be copied. Thus* the first form 
indicate lines n through m of the input file will be copied to 
the output fi1e* the second form indictes UPDATE will delete any 
lines up to n* but net including n* from the output file* The 
third form will cause UPDATE to copy the input file from the 
current position through line m. 

Examp Ies 

S5C 

$50*60 is ILLEGAL* but 

$ 11*20 

$21 is LEGAL 


SOON E 
$GUIT 

DONE causes the remainder of the input file to be copied to the 
output file until and end of file is detected. Unless in MERGE 
mode* _ control returns tc the system. QUIT causes the remainder of 
the input file^ to be deleted from the output file. Unless in 
MERGE* control is then passed tc the system. 

SMERGF f 11 ename 


This command switches the input to the named file. Input 
continues from this file until SOONE or SQUIT keywords are 
detected. Command then_resumes from the previous input file. 

SPAUSE Text 

This command causes UPDATE tc halt and display Text to the 
operator. Pressing the spacebar continues UPDATE. 
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Note: Commands where s i s followed by a Keyword may be 

abbreviated to their first letter (E.G., $p f cr SPAUSE). 


Source lines r e ad f rcm ca r ds 
The backslash \ may be used 
Paper Tape Input in section 


cr tape are in standard ASCII form# 
as a tab character as described for 
9#8#4*1#i* 


A source line must not begin with the UFDATE command character: 
$. A source line, if it appears in the UPDATE command stream* is 
copied onto the output file# 


Example: UP DATE *L IN*OUT*BLACK 

THIS IS A SOURCE LINE 
$*23 

$26*23 - 

■ $done r '-; 


The source file IN on the currently selected unit is updated and 
the output written to source file OUT with LABEL BLACK on the 
same unit* The new file consists of THIS IS A SOURCE LINE 
followed by hres 1 through 23* 26 through 28 and 30 though the 
end of the file. All update input is logged to the printer® 


VERIFY: Verify Fi!e/0iskette Label 


Load: 

VFRIFY Unit*DSN 
VE*Option Fiie*Label 

Options: 


File is a dat a file# 

File is an object file# 

File is a relocatable file# 
File is a source file. 


Note: Options are only permitted for the second load request* 

VERIFY is used in batch (cards* tape* file command; mode tc 
verify that a diskette has the expected dskname (that the correct 
diskette is loaded;# 

VERIFY can also bs used to verify that a file is present and has 

the expected label by loading the utility in the second load 
T o rm at» 

si9nsls a n error condition if the expected DSN or file 
label does not match the actual one# 

Example: VE 1*IHADSX 
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VEjQ 1•FILE*LA BEL 

Verify that the diskette cn unit one has dskname IMADSK* 
Verify that the object file FILE cn unit one has label LABEL* 

9*9* Diskette Errors 


Certain general types of errors in diskette input/output occur as 

TOllCWS! 


Sea rch Check 


Read Check 


Verify Check* 


Unit I nope ra b i e 


Write Protect 


A sector can not be found* Either the 
diskette is i nr, properly formatted* the heads 
are seeked to the wrong track* the prior 
sector had a cyclic check error* no diskette 
is mounted* the drive*s door is opened or the 
hardware is maIfunctioning• 

A cyclic check comparison repeatedly failed 
efter several attempts at reading the data. 
This condition indicates that the data was 
recorded incorrectly* 

A cyclic check comparison failed during a 
write operation* The error may be in the 
orevicus sector (indicating incorrectly 
recorded data) or in the sector being written 
if the verify option is used (indicating a 
damaged disk surface)* 

The diskette unit is inoperable* This 
condition is most usually caused by reloading 
the unit at a time when a reload was not 
permitted (E.G*> reloading the source file 
diskette unit in the middle of an assembly). 

A write was attempted to a diskette which was 
write protected (write tab attached or write 
protect button depressed). 


Segment Load Error In an overlay program* an attempt to load an 

overlay segment failed due to a diskette 
input error* If this happens* the object 
program file should be abandoned and a backup 
copy used* 


* Formerly called a Write Check. 
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9*10* SPD/OOS Error Codes 


9*1 1 


•1* ASSEMBLE Error Cedes 


AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 

AS 


sou rc e 
sour c e 
source 
sou rc e 
obj e ct 


01 F rror open ing 

02 Error opening 

03 Error opening 

04 Fjrror opening 

05 E rrer creating 

06 Error creating object 

07 Error creating object 

08 Error creating object 

09 Frrcr creating object 

10 Error Creating object 

11 Error opening work 

12 Error epening 

13 Error opening 

14 Error epening 

15 Work file too 


file* 
file* 
file* 
file* 
file* 
file* 
file* 
file* 
file* 
file* 
file* 
work file* 
work file* 
wo r k file* 
sma l I • 


NOTE: These error codes have 
not been updated to reflect 
changes in SPD/DOS. Hence 

C-, _ ^ U ~ I_- I. 


Search check* 

Read check* 

Unit inoperable 
File not found* 
Search check* 

Read check* 

Unit inoperabIe* 
Duplicate file name 
Write protect• 

File area full* 
Search check* 

Read check* 

Unit inoperable* 

File not found 


are 


some 
wrong. 


AS 

1 7 

E rror 

reading 

source file* 

Search check* 

AS 

IS 

E rror 

reading 

source file* 

Read check* 

AS 

19 

E r ror 

reading 

source file* 

Unit inoperable* 

AS 

20 

Error 

read ing 

source file* 

Missing end of file 

AS 

21 

Eir r or 

w-r i t ing 

object file* 

Search check* 

AS 

22 

Error 

writing 

object file* 

Verify check* 

AS 

23 

Error 

writing 

object file. 

Unit inoperable® 

AS 

24 

Error 

writing 

object file* 

File area exhausted 

AS 

25 

F;rror 

writing 

object file* 

Write protect* 

AS 

26 

Frrcr 

rea ding 

work 

f i l e 9 

Search check* 

AS 

27 

E rror 

reading 

work 

file* 

Read check* 

AS 

28 

Error 

read ing 

work 

file* 

Unit inoperable* 

AS 

30 

Error 

wr i ting 

wer k 

file* 

Search check* 

AS 

31 

E.r ror 

writ ing 

wor k 

file* 

Verify check* 

AS 

32 

E rrer 

writing 

work 

file* 

Unit inoprabl e* 

AS 

33 

Error 

writing 

work 

file* 

Work file full* 

AS 

34 

E rror 

writing 

work 

file. 

Write protect* 

AS 

35 

Segment lead error* 


AS 

36 

Parameter format error* 


AS 

37 

F rror 

open ing 

list 

file* 

Search check* 

AS 

38 

E rror 

epening 

l ist 

file* 

Read check* 

AS 

39 

E rror 

open ing 

list 

f i 1 e • 

Unit inoperable* 

AS 

40 

F rror 

epe n ing 

l ist 

file* 

File not found* 

AS 

41 

Error 

opening 

1 ist 

f i 1 e * 

Write protect* 

AS 

42 

Error 

writing 

list 

f i l e • 

Search check* 

AS 

43 

Error 

writing 

1 ist 

file* 

Verify check* 

A S 

44 

E.r ror 

writing 

1 ist 

file* 

Unit inopeable* 

AS 

45 

E rrer 

writing 

list 

file* 

File area exhausted 

AS 

46 

Error 

writing 

l ist 

file* 

Write protect* 

AS 

47 

Incorrect file 

allocation for disk reload* 
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9*10*2* CNFG Error Codes 


C N01 

Attempted use 

CN02 

E rror 

rea ding 

CN03 

Error 

rea ding 

CN04 

Error 

rea ding 

C NO 5 

E rrer 

writing 

C NO 6 

E rrer 

vriting 

CNO 7 

F rrer 

writing 

CND8 

E rrer 

writing 


in other than keyboard mode* 
label record* Search check* 
label record* Read check* 
label record* Unit inoperable* 
label record* Search check* 
label record* Verify Check* 
label record* Unit inoperable* 
label record* Write protect* 


9*10*3* COPY Error Cedes 


C001 
COO 2 
C003 
C004 
COOS 
COO 6 
COO 7 
COOS 
CO 0 9 
C010 
C011 
C01 2 
CO 1 3 
C01 4 
C01 5 
C016 
C01 7 
C01 8 
C01 9 
CO 20 
CQ21 
C02 2 
C02 3 
C024 
C025 
C026 


Frrcr opening input file. Search check. 

Error opening input file. Read check.k. 

Error opening input file* Unit inoperable* 

Error opening input file. File not found. 

Error creating output file. Search check* 

Error creating output file* Read check* 

Error creating output file* Unit inoperable* 
Error creating output file. Duplicate file name. 
Error creating output file* Write protect* 

Error creating output file* File area full. 

Error reading input file* Searcn check* 

Error reading input file. Read check. 

Error reading input file. Unit inoperable, 

trror reading input file* Mising end of file 
E;rrcr writing output file* Search check* 

Error writing output file. Yerify check* 

Error writing output file* Unit inoperable* 
Error writing output file* File area exhausted* 
E;rror writing output file* Write protect* 

Error reading external medium* 

Error writing external medium. 

Boot mode program too long to write to cassette* 
Missing Dj> 0j Rj S option or more than one opt* 
Parameter format error* 

Segment load error* 

Verify error* 
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9*10.4® Create Error Codes 


CR01 

F r ror 

creating file* 

Search check® 

CR 0 2 

Error 

creating file® 

Read 

check. 

CR 03 

E r ror 

creating file® 

Unit 

inoperab1e. 

CRQ4 

E rrcr 

creating file® 

Duplicate file name 

CR 05 

Error 

cresting file® 

Write 

prct ect• 

CR 0 6 

Error 

creating file® 

File 

area full. 

CRG 7 

E rror 

initia 1 izing file® 

Search check. 

CR08 

Error 

initial izing file® 

Write 

check® 

CR09 

Error 

initializing fi1e® 

Unit 

inoperab i e® 

CR10 

Error 

initial izing fi1e. 

File 

area exhausted 

C R11 

Ejrror 

initial izing file® 

Write 

protect® 

CR 12 

Parameter format error® 



9.10*5® DCOPY Error Codes 


EC01 Error opening input file* Search check® 

DC02 Error opening input file® Read check® 

0C03 Error opening input file® Unit inoperable® 

DC04 Error opening input file. File not found® 

DC05 Ejrror creating input file® Search check® 

DC06 Error creating input file® Read check® 

0C07 Error creating input file. Unit inoperable. 

0C08 Error creating input file. Duplicate file name 

PC09 Error creating input file. Write protect. 

DC10 E;rrcr creating input file. File area full. 

Error reading input file. Search check® 

QC12 Error reading input file® Read check. 

QC13 Error reading input file. Unit inoperable. 

&C14. Error reading input file. hissing end of file 

DC15 E;rrer writing output file. Search check. 

DC16 Error writing output file. Verfiy check. 

DC17 Error writing output file. Unit inoperable. 

DC18 Frror writing output file. File area exhausted 

DC19 Error writing output file® Write protect* 

^£23 hissing Dj 0 j R» or S option or more than 

option. 

0C24 Parameter format error® 

QC25 Segment load error® 






on e 
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9.10.6® EDIT Error Codes 


E D01 
ED02 
E003 
FD04 
FD05 
F DO 6 
F DO 7 
C O08 
F DO 9 
FDIO 
FD11 
FD12 
E013 
E n 14 
EDI 5 
EDI 6 
EDI 7 


Error opening input file* Search check* 

Frrcr opening input file* Read check* 

Error opening input file* Unit inoperable* 

Error opening input file* File not found* 

Error Creating output file* Search check* 

Error creating output file* Read check* 

Error creating output file* Unit inoperable* 
Error creating output file* Duplicate file name. 
Frror creating output file* Write protect* 

Error creating output file. File area full* 

E;rror writing output file. Search check* 

Error writing output file* Verify check* 

Error writing output file. Unit inoperable. 
Error writing output file* File area exhausted* 
E]rrcr writing output file* Write protect* 
Segment load error* 

Parameter format error* 


9*10*7* ERASE Error Codes 


ED 01 
EDO 2 
EDO 3 
ED04 
ED05 
E DO 6 
EDO 7 
ED0 8 
£nC9 
EDI Q 


E,rror reading directory* Search check* 

Error reading directory. Read check. 

Error reading directory. Unit inoperable. 

Error writing directory* Search check. 

Error writing directory. Verify check. 

Frrcr writing directory. Unit inoperable* 

Error writing directory. Write protect* 

Specified file not found and I option net set* 
Missing Dj Oj Rj> or S option* 

Parameter format error* 


9.10.8* FORMAT Error Codes 


F0Q1 

F002 

FC03 

F004 

FC05 

F006 

FQO 7 

FOGS 

F009 

F010 

F011 

F01 2 

F0 13 


Error formating diskette. Search check* 

Error formating diskette. Verify check* 

Error formating diskette. Unit inoperable. 

Error formating diskette. Write protect. 

Error writing diskette. Search check# 

Error writing diskette. Verify check* 

Error writing diskette. Unit inoperable* 

Error writing diskette. Write protect. 

Parameter format error. 

Segment lead error* 

Error reading label record* Search check. 
Frror reading label record. Read check. 

Frrcr reading label record. Unit inoperable* 
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9•10•9• LIST Error Cedes 


L 101 

Error 

opening 

file* 

Search check* 

LIG2 

Error 

opening 

file* 

Read check* 

L103 

Error 

opening 

file® 

Unit inoperable* 

L104 

Error 

opening 

f i l e* 

File not found* 

LI 05 

Error 

rea ding 

f i i e* 

Search check* 

LIC6 

E rrer 

reading 

file* 

Read check* 

L10 7 

F r ror 

reading 

file* 

Unit inoperable* 

LI08 

E rror 

reading 

file* 

Missing end of file 

L10 9 

Missing Dj 0j 

R or S option 

• 

L110 

Parameter format error* 



9.10*10* NuCileus Error Codes 


NU01 

Error 

reading 

directory• 

Search check* 

NU01 

E.rror 

res ding 

directory* 

Read check* 

NU01 

F rror 

reading 

directory* 

Unit inoperab1e» 

NUQ1 

Error 

reading 

label sector* 

Search check* 

NUQ1 

E r ror 

reading 

label sector* 

Read check. 

NU06 

E rror 

reading 

label sector* 

Unit inoperable * 

MUG 7 

Ejrrcr 

open ing 

object file* 

Search check* 

NU0 8 

Error 

opening 

object file* 

Verify check* 

NU0 9 

F rror 

opening 

object file. 

Unit inoperabie* 

MU 10 

F r r or 

ope n inc 

object file. 

File not found* 

NU11 

F rror 

loa ding 

program* 

Search check* 

MU12 

p rr cr 

loa ding 

program* 

Read check* 

NU13 

E r rcr 

loading 

program* 

Unit inoperable* 

N U14 

Error 

loading 

program* 

Improper object file 
format• 

N U1 5 

F rror 

load ing 

program• 

Wrong system or Boot 
mode* 

NU1 6 

Error 

loading 

program* 

Insufficient memory on 
20/20 or 10/24. 

M U1 7 

E rror 

opening 

command file* 

Search check* 

NU18 

Error 

opening 

command file* 

Read check* 

NU19 

Error 

opening 

command file. 

Unit inoperable* 

MU20 

Error 

opening 

command file. 

Fi l e not found* 

MU21 

Error 

reading 

command file. 

Search check* 

NU22 

Error 

reading 

command file* 

Read check* 

NU23 

Error 

reading 

command file* 

Unit inoperable* 

NU24 

E r ro r 

reading 

command file* 

Improper format* 

MU25 

Card reader not configured* 

NU26 

Tape reader not configured* 


NU27 

Command format 

error* 


NU28 

Error 

writ ing 

label sector• 

Search check* 

NU2 9 

Error 

wr i ting 

label sector* 

Write check* 

N U30 

E rror 

writ ing 

label sector* 

Unit inoperable* 

NU31 

E rror 

writ ing 

label sector* 

Write protect* 
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11 * PACK 

Error 

Cedes 


PA 0.1 

E rror 

rea ding 

diskette* 

P AO 2 

F rror 

rea ding 

diskette* 

PA03 

F rror 

reading 

diskette* 

PA04 

F rror 

writing 

d i s k et t e • 

P AOS 

F rror 

writing 

dis k ette* 

P AO 6 

F rror 

writing 

diskette* 

P AO 7 

F rror 

writing 

diskette* 

P ACS 

Parameter format error* 



Search check* 
Read check* 

Unit inoperab 1 e* 
Search check* 
Verify check* 
Unit inoperabIe* 
Write protect* 
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9*10*11*1* RASSFMBL Error Codes 


RA01 

F rrcr 

opening 

source fiIe* 

Sea rch check* 

,R AQ2 

F rror 

opening 

source fiie* 

Read check* 

R A 03 

Fir re r 

opening 

source file* 

Unit inoperable 

RA04 

F;rror 

opening 

source file* 

File not found 

RA05 

Error 

creating reic file* 

Search check* 

R A 0 6 

E rrcr 

creatinc 

re 1o file* 

Read check* 

RAO 7 

Sr r or 

creatine 

re 1o file* 

Unit inoperable 

R A 0 8 

E rror 

creatine 

re 1o file* 

Duplicate file name 

R A 0 9 

E rror 

creating 

re Jo file* 

Write protect* 

raio 

F rror 

creating 

re 1o file* 

File area fu l 1 • 

RA11 

F rror 

opening 

work 

file* 

Search check* 

R A12 

f rror 

opening 

work 

file* 

Read check* 

R A13 

F rrcr 

opening 

work 

file* 

Unit inoperable 

RAU 

E rror 

open ing 

work 

file* 

Fi1e not found 

RA15 

Work file size 

t G O 

sma 1 l • 


R A1 7 

Eirrcr 

rea ding 

source fi1e* 

Seach check* 

RAIS 

E;r rcr 

reading 

source file* 

Read check* 

R A19 

Error 

rea ding 

source file* 

Unit inoperable 

R A20 

F rrcr 

rea ding 

source file* 

Missing EOF 

R A21 

F rrcr 

writing 

re l o 

f i 1 e* 

Search check* 

R A 22 

F rror 

wr iting 

re l o 

file* 

Verify check* 

R A 23 

Error 

writing 

re 1 o 

file* 

Unit inoperable 

R A 24 

Error 

writing 

re l o 

file* 

File a rea full 

R *25 

Error 

writing 

re l o 

file* 

Write protect* 

RA26 

E rror 

rea ding 

wor k 

file* 

Search check* 

R A2 7 

Error 

rea ding 

wor k 

f i l e* 

Read check* 

R A28 

Error 

rea ding 

work 

file* 

Unit inoperable 

R A30 

p rr or 

writing 

wc-rk 

f i i e* 

Search check* 

R A 31 

F rror 

writ ing 

work 

file* 

Verify check* 

RA32 

Error 

wr it ing 

work 

file* 

Unit inoperable 

RA33 

Error 

writing 

work 

file* 

Work file full* 

R A 3 4 

E rror 

writing 

work 

file* 

Write protect* 

R A 35 

Segment load error* 


R A36 

Parameter format error* 


R A37 

F rror 

opening 

11st 

file* 

Search check* 

R A38 

E.r rcr 

opening 

1 ist 

file* 

Read check* 

R A 39 

Error 

opening 

! ist 

file* 

Unit inoperable 

RA40 

Error 

open ing 

list 

file* 

File not found* 

RA41 

E.r rcr 

open ing 

list 

file* 

Write protect* 

R A4 2 

E.r rcr 

writing 

list 

file* 

Search check* 

R A43 

E rrcr 

writing 

l ist 

file* 

Verify check* 

R A44 

F rrcr 

writ ing 

list 

file* 

Unit inoperable* 

R A45 

F rror 

writing 

l ist 

f i l e , 

File area full* 

R A46 

Error 

writing 

list 

file* 

Write protect* 

RA47 

Incorrect file 

silocation for 

diskette reload* 


9-5 6 



9*10*12* R FN AMF Error Codes 


RE01 
RE02 
RF03 
R “04 
RFD5 
RP06 
RE0 7 
RE09 
R El 0 
R E11 
R El 2 


Error reading directory* 
Error reading directory* 
E.rrcr reading directory* 
Specified file not found* 
Error writing directory* 
Error writing directory* 
Error writing directory* 
Error writing directory* 

New file name not unique* 
Missing or duplicate option 
Parameter format error* 


Search check* 
Read check* 

Unit inoperab le* 

Search check* 
Verify check* 
Unit inoperab I e* 
Write protect* 


9*10*13* TMOVF Frror Codes 


TrtOI 
TM 02 
TM03 
TM04 
TM05 
TMO 6 


Tape unit is off line or formatter turned off* 
Attempt, to backspace past BOX* 

Attempt to position past double end of file* 
Attempt to position past EOT. 

Read error during list option* 

Parmeter format error* 
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9*10*14* UPDATE Error Codes 


UP01 
UP02 
UP03 
UP04 
UP05 
UPO 6 
UPO 7 
UP08 
UP09 
UP10 
UP11 
UP1 2 
UP 1 4 
UP15 
UP1 6 
UP1 7 
UP 1 8 
UP1 9 
UP 20 
U P 21 
UP22 
UP 23 
UP 24 

U P 25 
UP 2 6 
UP2 7 
UP28 
UP29 


Error opening input cr merge 
Error opening input or merge 
Error opening input or merge 
Error opening input or merge 
Error creating output file* 
Error creating output file* 
Error creating output file* 
Error creating output file* 
Error creating output file* 
Error creating output file. 
Error reading input or merge 
Error reading input or merge 
Error reading input or merge 
E;rr.or writing output file* 
Error writing output file* 
Error writng output file* 
Error writng output file* 
Error writng output file* 
Error reading command file* 
Error reading command file* 
Frror reading command file* 
Error reading command file* 
End of file on command input* 


Search check 
Read check* 

Unit inoperable* 
File not fcund• 
Search check* 
Read check* 

Unit incperable* 
Duplicate file* 
Write protect* 
File area fulI* 
Search check 
Read Check 
Missing EOF* 
Search check* 
Verify check* 

Un it incperable* 
Fi I e a rea full* 
Write protect* 
Search check* 
Read check* 

Unit inoperabl e* 
Source format* 


UPDATE command error* 
U'PDATE command error* 
UPDATE command error* 
Parameter format error* 
Segment load error* 


Unrecognized type 
Syntax error* 

Line number error 


9*10*15* VERIFY Error Codes 


Frror reading* Search check* 

VE °2 Frror reading* Read check* 

Vf r 03 Error reading* Unit inoperable. 

VEQ4 Specified file not found* 

V p 05 File label match verify error* 

VE06 Diskette serial number match verify error* 

VEQ7 Parameter format error* 
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9*10*16* ZAP Error Codes 


ZA01 
ZA02 
ZA03 
ZA04 
ZA05 
Z AO 6 
ZaO 7 
Z AO 8 
ZA09 
ZAIO 
ZA11 
Z A1 2 
ZA13 
Z A14 
ZA15 
ZA1 6 
Z A1 7 
Z Al 8 
Z A1 9 
ZA20 
ZA21 
Z A 22 


F r ro r 
Error 
Frrcr 
F rror 
E rror 
F rror 
F rror 
F rror 
Error 
F rror 
F rror 
F rror 
F rror 
Fjr r or 
F rror 
Error 
Error 
Ejrr.or 
E rror 
F rror 
r rrcr 
Error 


opening 
ope n ing 
open ing 
opening 
creating 
creating 
creating 
creating 
creating 
creating 
rea ding 
rea ding 
rea ding 
writing 
writing 
«r i t ing 
writ ing 
writing 
res ding 
res ding 
rea dirg 
rea ding 


input 

input 

input 

input 


file# 

file* 

file* 

file* 


output 
output 
output 
output 
output 
output 
inp ut 
input 


file* 
file* 
file* 
file* 
file* 
file* 
file* 
file* 


input file* 
output file* 


output 
output 
cutpu t 
output 
command 


file* 
file* 
file* 
file* 
f i I e * 


comma nd file* 
comma nd file* 
command file* 


Search check* 

Read check* 

Unit incperabIe• 

File net found* 
Search check* 

Read check* 

Unit inoperabie* 
Duplicate file name* 
Write protect* 

File area full* 
Search check* 

Read check* 

Unit inoperable* 
Search check* 

Verify check* 

Unit inoperable* 

File area exhausted* 
Write protect* 

Search check* 

Read check* 

Unit inoperabIe* 
Missing end of file* 


Z A 2? 
Z A 24 
ZA25 
ZA26 
Z A2 7 
ZA28 
Z A 2 9 


Error reading 
Error reading 
Error reading 
Error writing 
Error writing 
Error wr i t i n g 
Error writing 


cere image 
cere image 
cere image 
core image 
cere image 
cere image 
core image 


wg r k file® 
wo rk file* 
wo rk file* 
work file* 
work file* 
work file* 
work file* 


Search check 
Reed check* 
Unit inoper* 
Search check 
Verify check 
Un it inoper• 
Write prot 


ZA30 
Z A 31 
Z A 32 
ZA33 
ZA34 

Z A3 6 

Z A3 7 
ZA 38 
Z A 39 


End cf command file encountered* 

Parameter format error* 

ZAP command format error* 

L command invalid (no input file) 

S command invalid (no output file or segment 
already stored* 

Wrong system (wrong model 7PU* external memory 
present)* 

Segment load error* 

ZAP V reject due to data mismatch* 

Error writing load cassette* 
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1C* SPD/OOS Assembler Guide 


The SPD/DOS Assembler is a utility which allows the user to 
p rod ram _ directly in mnemonics. It permits full access to the 
capabilities cf the processing unit (TPU) while relieving the 
programmer of the mammouth tasks associated with writino machine 
code* 

The mnemonics.recognized by the assembler are identical to those 
giver in section 2** . Instruct ion Repertoire* In addition* various 
pseudo-ops are available which control the assembly process 
itself* ' 

The ASSEMBLE utility ailows assembling source statements into 
absolute code in a form suitable for loading by the DOS loader* 
The RASSEMBL utility assembles source cede into relocatable 
modules suitable for inclusion into absolute assemblies through 
the IN pseude-cp* This section is intended as a quick reference 
guide to the SPD/DCS assembler and relocatable assembler 
utilities* For a complete description of the syntax of the 
language and more detailed information* consult the SPH Symbolic 
Assembly Language Reference Manual. 


10*1. Assembly Source Format 


Source line length: 80 characters* but the SPD/DOS editor 

restricts line length to 64 characters* 

Character set: Upper case ASCII set* codes X^O 1 - x*5F** 

Special characters: Typical Use: 


$ 

<5 

i 

( 

) 

x 

% 

n 


/ 

0-9 


A-Z 


Dollar 
Ampersar* d 
Quote 

Open parenthesis 

Close parenthesis 

Asterisk 

Per cent 

Hash 

P lus 

Comma 

M i n us 

Period 

S l ash 

Digits 

Equals 

At 

Letters 


Assembly symbols 
Title modification 
De!imit er 
Express ions 
Expressions 

Multiplication* comment 

Names and Labels 

Comments 

Expressions 

Ope ran d separation 

Subt ra ct1 on 

Opera nos 

Division 

x*x 

Literals* expressions 
Indexing 
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10 • 1 • 1 • 


Source Line Format 


Column Conventions: 

1 10 16 30 

Lsbel Opcode Operands Comments 


Comment Lines: 

1 

* Comments 
U D e|et a b I e Commen ts 

Title Modification 

1 ; 

% Main Title Modification 
1 Sub-title Modification 

10*2* Expressions 


Data Constant Specificat ion 

Decimal integer 
Binary integer 
Octal integer 
Hexadecimal integer 
Single character ASCII constant* 
Double character ASCII constant 


Assembler Symbols 

$ Current value of Location counter 

16 bit value set during Assembler load 
SB Duplication count 

$L Current value of Load counter 

SX cr SC The location of the CUR: FFE 

** Zero constant operand 


* To include a quote one simply writes * * * 


nor D 1 n 1 

B » n« 

0 * n* 

X 1 n* 

■ a * 

1 ab * 
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Assembler Operators 
Order of Precedence 

Highest 


* / 


+ 


* R $ • • L S • 


» EQ. .N E • * GT • 

• LT. *LE * • GF • 


• AND. 


• OR. 


. XOR » 


1Q • 2 • 1 • A S S EM EL E/R £S 5 EM 3L : Options 


Lea d: 

ASSEM8LE<jQptions> Sfile<jb<^Cfile><jLabel>> 

AS<jOptions> Sfile 

RASSFM3L: Relocatable Assembly 

Load: 

R ASSEMBL<jCpticns> Sfi I e<jb<jRfil eXjLabe l >> 

RA<*0pticns> Sfile 

Note the nesting of parameters. This specifies the parameters 
that may be omitted. 


Opt ions: 

A Alternate Unit. The object or relocatable file is 

generated cn the unit opposite from that implied by the 
call, 

8 Both pass. Print on pass 1 and pass 2. 

C Clean. Enforce LIF 0: IF/ENDF and deleted cede are never 

printed* 

Definitions. iNclude DOS standard definitions module* 
Use of this option can be avoided by iNciuding O&DEFS at 
the appropriate location in the code. 

E Frase duplicate object file* 

F FyiI list* Enforce LIF 2 mode: AlI IF/ENDFj plus deleted 


10-3 











code is printed* 

Generate IN codes Enforce LIN 1* iNcluded code is 
listed* 

Hold In codes Enforce LIN 0* iNciuded code is listed 
only for errors* 

Inhibit object file production* 

Kill Hash comments* Enforce List 2 mode* Ejects and 
subtitles are used to format the listing* 

FnforceList 3* Hash comments are listed* 

NoPrinter? Print source listing in LIST file* 

Omit* Omits literal cross references* 

Paper save* Enforce List 1 * eject and subtitles are 
treated as comments* Hash comments are killed* 

Quick Assembly* XREF Q# No cross reference is generated* 

Reference unassembled: Enforce XREF 2* Cross reference 
for deleted IF/FNDF code is generated* 

Short List* Print only errors* 

Table of Contents* Shows the initial page number of each 
subtitle line* It is printed immediately before the 
listing of the first subtitle line* 

Unlist deleted_cede: Enforce LIF 1. Code deleted* plus 
IF/ENDF lines in fa Ise IF rangesj is not printed* 

Verify writes to object* WORK and LIST are never 

verified* 

Cross Reference: Enforce XRFF 1, Collect cross 

references in assembled areas* 

ASSEMBLE utility only 



10*2*2* Assembler Pseudo-Operations 


FUNCTION 

KEY 

. MNEMONIC 

DATA 

1 

ADDR 

ed*ed*» * 

DEFINITION 1 

addr 

n<ed> 


1 

ALGN 



! 

. BSS 

n 


1 

ESZ 

n 



BYTE 

ed* ed *• • 


\ 

BYTE 

n <ed> 


a* 1 

DAC 

<address> 


a* } 

OACx 

<address> 


I 

HFX 

< hex> 


1 

L8L 




LTXT 

d<st ring>d 


1 

LTXS 

d<st ring >d 


1 

TEXT 

a<st r ing>d 


l 

TXT8 

d<string>d 


a* 1 

WORD 

ed* ed*« • 


a* 1 

WORD 

n <ed> 

PROGR AM 

x 

BOOT 


CONTROL 

a* 1 

BSL 

n 



CNFG 

n 


r* l 

DFF 

s ymb 1 



. CUP 

n 


* 

FAM 

n 



END 

< ent ry > 



ENDF 



symb I 

ECU 

n 


X 

ESEG 

< ent ry > 



IF 

<test > 


a * x * 1 

IN 

f i 1 e* mo du 1 e 


MEANING 


Generate two byte data* 
n = explicit decima l 

integer* 

Align data to word 
boundary 

Define n storage bytes 
Zeros n storage bytes 
Generate byte data 
n=explicit decimal 

integer 

Generate address const 
Set indirect bit on 
Generate <hex> data 
Generate label data 
Generate lower case text* 

Set MSB on 

Generate text string 

Set MSB on 

Generate word data 

n=Fxpiicit decimal 

integer 

Set Boot mode 
Specify local literals 
n^Number of bytes* even* 
aval I a bIe 

Specify Configuration 

n= 1 G *2 0 * 24 * 2 5 *0 

Define symbol 

Duplicate source line n 

times* 

Enter Extended Addressing 
Mode if n=1• If n not 
given* EAM 1* 

End Assembly* <entry> 
opt Iona I 

End Cond* Assembly 
Equate symbol to value 
End overlay segment 
<entry>=Segment entry 
point* optional 
Start Conditional Assem 
<test>=C: Code to ENDF 

ignored 

Include Relocatable hod 
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FUNCTION 


KEY 


mnemonic 


MEANING 


PRO GRAM 
LISTING 


x LIT < symbl>«• 


Labe I MOO 

x NOB J 

x OBJ 

xj I ORG <address> 

r TOP 

xjLebe! SEG <address> 


Symb J SET n 

SIZE szj Ink* xs z 


l jx XORG < 1 oc><* ld> 


r XTN symb1 

x EJECT 

LIE n 


LIN n 

PAGE n 

XREF n 


<3tit ie 
1 subt it I e 


Specify main literals 
n=Value to be placed in 
main peel 

Define Relocatable Med 
Turn off object output 
Turn on object output 
Set Assembly origin 
Top sector code follows 
Start overlay segment 
<address>=Origin of 

segmentjopticnaI 
Set symbol to value 
Specify memory size 
sz=Last byte address* 
Top limit for Lit. table. 
xsz=Externa| memory size* 

Set execution origin 
lcc=Locaticn counter! $ * 
ld=Load counter! $L 
Externa 1 symbol(s ) 

Eject listing 
Control IF listing n=0: 
Never printed* n=1 false 
ranges not listed* n=2 
Full list 

Control IN listing r,=0 No 
listing except errors 
Set Page Depth to n 
Set Cross Reference n=G 
No Xref* n=1* Xref in 
Assembled areas n=2: Full 
Xref 

Main title modification & 
must start in column 1 
Subtitle modification 1 
must start in column 1 


NOTE: Insert after CNFG 


r copy File,Module 


copy 

reloc module 
into a reloc 
assembly. 
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KEY s 


a 

d 

l 

n 

r 

x 

ed 

wa 

x 

Labe 1 
symb I 
address 


Aligned to word boundary 
Oelimiters any character not in string 
Label permitted 
As defined 

Relocatable Assemblies Only 

Absolute Assemblies Only 

Effective data 

Word Address* must be even 

SPD 20 Family models Only 

required label 

Valid assembler symbol 

Valid address* as enforced by SIZE 


10*3* Addressing Restrictions 


CNFG 

CGR r 

SIZE 

L ow* 

High 

10(25) 

4K 

Defa u11 

0000 

0 FFF 

20 

S K 

1 FFF 

oooc 

7C00 

1BFF 

7FFF 


1 6K 

3FFF 

0000 

7AG0 

39 FF 
7FFF 


3?K 

7FFF 

0000 

7FFF 


64K 

FFFF 

0G00 

FFFF 

24 

8* 

1 ^FF 

0000 

7C00 

1 8 FF 
7FFF 


1 6K 

3FFF 

0000 

7C00 

3BFF 

7FFF 

Compatible 

4K 

0 000 

ooco 

7E00 

ODFF 

7FFF 


1 

0000 

0000 

7F00 

3DFF 

7FFF 


32K 

0000 

0G00 

7FFF 


x Notes 

Seg merit 

0 Low 

= 0100 
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10 • 4 • Error Flags 


A Invalid address 

3 Violation of BOOT mode restriction 
C Erroneous character 

D Disk Error for Source or iNcluded Data 

E Odd operand whee even required 

F Forward reference not allowed 

H Missing END line 

I IF-ENDF nesting error 

L Label error 

M Multiple definition 

N Numeric error 

0 Invalid operation code 

P Parenthesis depth error 

C Invalid SIZE or CNFG parameter 

R Relccatability error 

S SEG—ESEG sequence error 

T Tabel overflow (Literal cr Symbol) 

U Undefined symbol 

V Missing operand 

U Extra operand 

X Invalid lead location 

Y Relocatable library cr module not found 

Z Symbol undefined due to symbol table 
overtIcw 

S Indexing error 

= Invalid literal 

x Invalid use of indirect addressing 
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11* Machine Codes Quick Reference 


SPD 10/25 
INSTRUCTION SET 


ASSEMBLER 

MNEMONIC 

CO DF 

EXEC* 

TIME 

ACTION 


AD* 

ea 

lOea 

2 

A CR = <ea > + ACR 

ADI 

ea 

90ed 

1 

ACR = ed 

+ ACR 

an* 

ea 

28ea 

2 

ACRl= ACR 

• *•< ea> 

ANI 

ed 

A 3ed 

1 

ACR = ACR 

• * •< ea> 

CIO 

f 3 C 

C9f c 

1 

Controlier function 

CJTRU* 

edjwa i 

A 4 e d - 

2 

P C R = ea 


CJFAL* 

edjwa 

AGed- 

1 

P CR = PCR 

+ 4 

C JEG* 

ed a 

A2ed- 

a 

P CR = wa 

ACR=ed 

C JGT* 

edjwa 

A Ted- 

n 

PCR = wa 

ACR >ed 

C JGE* 

ediva 

A5 ed- 

n 

PCR - wa 

ACR >=ed 

C JLT* 

ed svf a 

A1 ed- 

n 

PCR = wa 

ACR < ed 

C JLE* 

ed jw a 

A3ed- 

u 

PCR = wa 

ACR<=ea 

C JNE* 

edjw a 

A6ed- 

n 

PCR =' wa 

A CRlea 

CLA 


8000 

i 

ACR- = 0 


CLL 


CCGC 

1 

LIR = 0 


CM* 

ea 

^Gea 

2 

A C R • < e a > 


CMC* 

= W3 

7 Gwa 

3 

CUR • (wa y 


PEC* 

wa 

5 8wa 

2 

K wa> — <wa> — 1 

nse 


COO 7 

1 

DSB Interrupts 

C N8 


COO 6 

1 

EN8 Interrupts 

XOR 

ed 

C-Oed 

1 

ACR = ACR 

• —• e d 

HALT 


C0Q1 

u n 

STOPS TPU 


INC* 

w a 

50 wa 

2 

<wa> = <wa> + 1 

I N 2 * 

wa 

60 wd 

2 

<W3> = <w 

a y + 2 

I OR 


COOS 

1 

R esets TPU 

JFACK* 

f JCJW3 

CCf c- 

n 

PCR = wa 

IF NAK 

JTACK* 

f jCjwa 

CSf c- 

n 

PCR = wa 

IF ACK 
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ASSEMBLER 

MNEMONIC 


CO DE 

EXEC. 

TIME 

ACTION 

JCCO* 

wa 

8D00- 

it 

PCR = wa CO = 1 

JCEQ* 

wa 

8A00- 

tt 

PCR = wa EG = 1 

JCEV* 

wa 

SCO 2- 

n 

PCR = wa ACR LSB = 0 

JCGT* 

wa 

8F00- 

u 

PCR = wa (CO = 1 j EG = 0 

J CGPx 

wa 

8 boo- 

n 

PCR = wa CO = 1 

JCLTx 

wa 

8900- 

n 

PCR = wa CO = 0 

JCLE* 

wa 

8800- 

u 

PCR = wa EO = 1 or CO =i 

JCN 0* 

wa 

8801- 

t 

PCR = wa Result Byte Msb 

JCNC* 

wa 

8900- 

n 

PCR = wa CO = 0 

JCNE* 

wa 

8E00- 

tt 

PCR = wa EG = 0 

JCOD* 

w a 

8802- 

tt 

PCR = wa ACR LSB = 1 

JCPO* 

w a 

8C01- 

n 

PCR = wa Result Byte Msb 

jcfal* 

wa 

3800- 

1 

PCR = PCR + 4 

JCTRU* 

wa 

8C00- 

2 

PCR = wa 

JMPx 

wa 

33va 

1 

PCR * wa 

JS R 36 

wa 

78 wa 

2 

<wa> = PCR + 2. PCR = wa 

LO* 

ea 

GGea 

2 

ACR = <ea> 

LDI 

ed 

SCed 

I 

ACR = ed 

LDC* 

= wa 

40wa 

3 

CUR = <wa > 

MAC 


CQ05 

1 

CHR = ACR 

MAL 


C0G3 

1 

LIR = ACR 

MCA 


CC04 

1 

ACR = CHR 

MLA 


COO 2 

1 

ACR = LIR 

NOP 


COGC 

1 

Execution Delay: 1 cycle 

OR* 

ea 

30 e a 

2 

ACR = ACR• + •<ea > 

0 R I 

ed 

SOed 

1 

ACR * ACR.+.ed 

RIO 

f JC 

C Af c 

1 

ACR = INB 

SHL4 


COO 9 

1 

ACR = Arith Shift Left 4 

S B ^ 

ea 

1 8ea 

2 

ACR = ACR - <ea > 

SBI 

ed 

98ed 

1 

ACR = ACR - ed 

SKP 


8800 

1 

Skip next instruction 

S T 36 

ea 

0 8 e a 

2 

<ea > = ACR 

STC36 

wa 

48 wa 

2 

<wa> 12 LS3 = CUR 

WAIT 


COOF 

tut 

ENBj Interrupt Wait 

VIO 

f jC 

CBf c 

1 

OTS = ACR 

WJMP 

w a 

8C0G- 

1 

PCR = wa (16 bits) 
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LEGEND i 

c Devic e channeI 

f nevice function 

63 Byte Address.* even or odd 
ed effective data 
w a Word Address* must be even 


< > The CONTENTS of the address 

• + • Logica I Or 

»-* Logical Exclusive Or 

• * * LogicaI And 

* Indirect addressing permitted* Literal use permitted if 
indirect addressing is employed and if memory reference* 

= Literal use permitted* 


> GT 
>= GE 
< LT 
<= LF 
I NP 
= EG 


jfl 


ACR Accumulator 

CHR Character Register 

CUR Cursor Register 

IN8 Input Data Bus 

LIR Line Register 

0TB Output Data Bus 

PCR Program Counter Register 


Execution Times • 


1 cycle if no jump is takjj§n* else 2 cycles 

Wait fGr action from p rog r a mmers console* 1 cycle if no 

consoIe * 

Wait for next interrupt * return on NAK to instruction 
following WAIT * 


Indirect addressing: 1 cycle per level 
1 TPU cycle = 1*6 microseconds* 


Data Comparisons: 

Replace : with comparison to be; performed (E*Gj GTj LT j 
Cursor:<wa> becomes* JCGT jumps if Cirsor*GT*<wa>) 
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12* Summary of Controller Programming 


This section summarizes the INCOTERM Communications Controller 
command set* For detailed programming information j consult the 
INC0TFRM Communication Controller Reference Manual. 


12.1. Asynchronous Controller Command Summary 


Command Function 


CIO 

0 

Reset RTS 

CIO 

1 

General Reset 

CIO 

2 

Set Transmit Mode 

CIO 

3 

Set Receive Mode 

CIO 

4 

Set Line 3rake/Pricrity Data 

CIO 

4 

Set RTS 

CIO 

12 

Mask Interrupts 

CIO 

8 

Unmask Interrupts 

WIO 

1 

Write Data 

WIO 

2 

Set Data Terminal Ready 

WIO 

4 

Reset Data Terminal 

WIO 

? 

Set RTS 

RIO 

1 

Read Data 

TIO 

0 

ACK if Controller Present 

TIO 

1 

ACK if Data Set on Line/No EOT 

TIO 

2 

ACK if No Data Set Error 

TIO 

L 

ACK if Nc Overrun 

TIO 

8 

ACK if No Line Break/No Cancel 


12.1.1. Summary of Merged CIO Commands 


Command 

Fun cticn 

CIO 

13 

General Reset plus 

Mask Inter rupt s 

CIO 

o 

✓ 

Gen era 1 R es et p 1 us 

Unmask Interrupts 

CIO 

14 

Set Transmit Mode plus 

Mask Interrupts 

CIO 

6 

Set Transmit Mode plus 

Set Line 3reak/Priority Data 
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Co mmand 


Fun ction 


CIO 15 Set Receive Mode plus 

Unmask Interrupts 

CIO 11 Set Receive Mode plus 

Unmask Interrupts 

I2m2* Asynchronous Cntrlr/SPD-M Multiplexer 


Co mrr 

isnd 

Funct ion 

CIO 

1 

Gen era 1 Reset 

CIO 

2 

Set Transmit Mode 

CIO 

3 

Set Receive Mode 

CIO 

4 

Set Priority Data 

CIO 

12 

Mask Interrupts 

CIO 

8 

Unmask Interrupts 

WIO 

1 

Write Data 

RIO 

1 

Read Data 

TIO 

0 

ACK if Controller Present 

TIO 

1 

ACK if No EOT 

TIO 

2 

ACK if No Data Set Error 

TIO 

4 

ACK if No Overrun 

TIO 

8 

ACK if No Cancel 
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12«3« Party Line Controller Summary 


Command Function 


CIO 1 
CIO 2 
CIO 3 
CIO 4 
CIO 12 
CIO 8 
VIO 1 
RIO 1 
TIO 0 
TIO 4 
TIO 8 


Gen era I R es et 
Set Transmit Mode 
Set Receive Mode 
Set Line Break 
Mask Interrupts 
Unmask Interrupts 
Write Data 
Read nata 

ACK if Controller Present 
ACK if Mo Overrun 
ACK if Mo Line Break 


12*4« Synchronous Controller 


Command Function 


CIO 2 
CIO 4 
CIO 8 
CIO 10 
CIO 6 
VIO 0 
RIO 0 
TIO 0 
TIO 2 
TIO 4 
TIO 8 


General Reset 
Mask Interrupts 
Unmask Interrupts 
Set Transmit Mode 
Set Receive Mode 
Write Data 
Read Data 

ACK if Controller Present 

ACK if Mo Data Set Error/Cancel 

ACK if No Overrun 

ACK if Data Set On Line/EOT 
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S yn chrono us 


Command 


CIO 1 
CIO 2 
CIO 4 
CIO S 
CIO 10 
CIO 6 
WIO 0 
RIO 0 
TIO 0 
TIO 2 
TIO 4 
TIO 8 


Centr1r/SPO-M Multiplexer 


Fun ction 


Set Priority Data 
Gen era I R eset 
Mask Interrupts 
Unmask Interrupts 
Set Transmit Mode 
Set Receive Mode 
Write Data 
R ea d Da ta 

ACK if Controller Present 
ACK if No Cancel 
ACK if No Overrun 
ACK if Nc FOT 
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